Hotel-X Development - Search

We've prepared a collection of articles that will help you learn everything you need about the Hotel-X Search query.

Search Modes

  1. What is the difference between single mode and multimode when performing a Hotel-X Search?


  1. What is a plugin?


  1. What is the search query?

Frequently Asked Questions

  1. Is it mandatory to specify the timeout?
  2. What happens if I don't specify the access code?
  3. In case I would like to receive a specific rate, would it be possible?
  4. How can we differentiate a child from an infant? What is the age range of each of them?
  5. Can we define our own context for 2 or more test suppliers? This will help us to test how the requests will work with our own context.
  6. What happens if I don't specify the access code?
  7. Why there are so many fields with null value in the Search response?
  8. Which payment type options are available?
  9. What is the occupancyrefID?
  10. What is the id of the option?
  11. Can I personalize the Hotel-X queries and receive less/more information?
  12. What is a surcharge?
  13. Can I search the hotels by destination in the Hotel-X Hotel List query?
  14. Can I receive Daily-prices in Search Response?
  15. Am I going to receive the cancel policies in the search response?
  16. Is it possible to set a different timeout for each supplier when using the multimode?
  17. What does it mean when the option price is set as binding?
  18. What currencies are supported by the supplier?
  19. What happens if the supplier doesn’t support the currency requested in Search? Is it not returned?
  20. How to structure a multi-room in HotelX
  21. Does the client’s nationality or market affect the price returned?
  22. Can I use the OptionRefId code to implement some logic in my API?
  23. Can I build a calendar view with HotelX?
  24. What is the lifetime of the OptionRefId?
  25. Can I obtain the markets supported by each Seller through the Hotel-X API?
  26. What price do you return through Hotel-X?
  27. What is the "units" field returned under the rooms node in the Search response?
  28. What is the maximum number of rooms and pax per room that I can book?

Filters and limitations

  1. How many hotels code are allowed to be requested at the same time?
  2. Which are the possible filters in the Search Request?
  3. How many rooms can I request per search?
  4. Is there any limitation on the number of searches per minute I can do?
  5. Can I apply business rules and receive only the cheapest price in the response?
  6. Can I filter the Search results by the status of the option?


  1. I have received error 101 in my response. What does it mean?
  2. I have received an error code 102 in my response.
  3. I have received an error 204 - No results found. What does it mean?
  4. I have received an error code 207 in my response. What does it mean?
  5. I have received error 104 in my response. What does it mean?
  6. I have received error 105 - Communication Error in my response. What does it mean?
  7. I've received a "no valid access found" error, what can I do?
  8. I've received a "mapping" error, what can I do?
  9. I've received a "null" response, what can I do?

Best practices and recommendations

  1. What headers should I add in my Hotel-X queries and mutations?
  2. Should I add the "auditTransactions" field to my queries and mutations? When should I set it to true and when to false?
  3. What are the minimum fields you recommend to add to the Hotel-X Search query?
  4. What if we have our servers in China, is there any specific endpoint?
  5. What headers should I add in my Hotel-X queries and mutations?