Skip to main content

List of FAQs

Getting Started with Travelgate
Are you a Buyer?
  1. What resources are available for Hotel-X?
  2. What headers should I add to my Hotel-X requests?
  3. What languages does Hotel-X API support?
  4. What is an Apikey?
  5. What is an Access?
  6. What is a Client?
  7. What is a Context?
  8. What's the difference between access and context?
  9. Is it mandatory to specify a timeout in my request?
  10. Which timeout should I establish in each step?
  11. What happens if I set a higher timeout than the ones allowed at Travelgate API?
  12. My Legacy API request contains two timeout tags, what distinguishes one from the other?
  13. Why does Hotel-X add 150 milliseconds to my requests?
  14. What is the id (optionRefId) of an option?
  15. What is the lifetime of an OptionRefId?
  16. If I encounter an error in the Hotel-X QuoteRS, can I continue using the same Search "id" from Search?
  17. Is it possible to use the OptionRefId to implement any logic in my API?
  18. Can I apply any filters to my Search request?
  19. Can I search by destination?
  20. Are there any limitations on the number of searches/minute?
  21. Does nationality or market affect the price returned?
  22. Can we define our own context for 2 or more Suppliers?
  23. How can we differentiate a child from an infant? What is the age range of each of them?
  24. Can I receive a specific rate in Search response?
  25. Can I receive daily prices in Search response?
  26. How many parallel requests can Travelgate handle from a single Buyer?
  27. Can I filter the Hotel-X Search results by payment type?
  28. What is the lifespan of the Search id?
  29. Can I get a hotel description in Search response?
  30. How does Hotel-X Single Mode work?
  31. How does Hotel-X Multimode work?
  32. How can I optimize a high percentage of no availability?
  33. How can I filter my Search requests?
  34. How can I set up Business Rules in my requests?
  35. What is the occupancyrefID in SearchRS?
  36. Can I split the rooms returned within an Option and book them separately?
  37. What is the max. number of rooms and paxes/room allowed per reservation?
  38. What does the "units" field indicate in the "rooms" node of the SearchRS response?
  39. Do options get blocked in Hotel-X Quote Query?
  40. Are there any limitations on the number of Hotel-X Quote requests allowed per minute?
  41. Do I have to perform a Quote Query in order to Book an option?
  42. Is there any possibility to obtain RoomCodes in Quote?
  43. What should I do if I receive a status RQ in Quote response?
  44. What is the DeltaPrice?
  45. Will the currency in Book be the same as the currency in Quote?
  46. Do I have to provide real names and ages for all the passengers?
  47. How can I add remarks to a Book request?
  48. What payment details should I add to my Book request?
  49. What is a BookingID?
  50. What does the status in a reservation response indicate?
  51. What should I do if I receive both an OK status and an error in the same Book response?
  52. How can I obtain the Hotel Confirmation Number (HCN)?
  53. How are cancellation costs calculated and displayed?
  54. Is it possible to retrieve the cancellation costs without canceling the option?
  55. In a reservation for 2 rooms, if two rooms have the same cancellation policy, should the cancellation penalties be summed up in the node for the option?
  56. What does the status in a cancel response indicate?
  57. What should I do if I receive an error in Cancel response?
  58. How can I retrieve the details of a booking?
  59. How can I retrieve a list of all bookings made within a specific time frame?
  60. Can I search hotels by destination?
  61. How can I know the total amount of properties returned in Hotels Query?
  62. What is the difference between "hotelCode" and "hotelCodeSupplier"?
  63. What hotel codes should I map as Buyer?
  64. Will I receive availability results for all the properties within a Seller's portfolio?
  65. How should I utilize the zone and city nodes in my Destinations Query response?
  66. What destination codes should I map as a Buyer?
  67. Will I receive availability results for all the destinations returned in the Seller's destination list?
  68. Is it my responsibility to map Hotel-X Rooms? Or does Travelgate provide mapping support?
  69. What is a token (ContinuationToken)?
  70. What is the expiration time for the ContinuationToken?
  71. Can I obtain the list of amenities available at Travelgate?
  72. How can I access the list of Travelgate errors?
  73. How can I access my B2B Virtual Agency?
Inventory Buyer
Are you a Seller?
Account Settings
Dashboard
Connections
APPs
Support Cases