Quick Start
Hotel Trader’s GraphQL PULL API provides a complete and understandable description of the data in the API, allows you to ask for exactly what you need, makes it easier for Hotel Trader to enhance APIs over time, and enables powerful developer tools.
Next Steps
Explore our GraphQL API Schema
OR
Have Questions? Visit our FAQ page or write to your Hotel Trader contact.
Explore our GraphQL API Schema
Explore our API schema and documentation on the GraphQL Editor
Visit Schema and Docs for more details on using the GraphQL GUI for schema and documentation.
Get Started with Development
Start development with our GraphQL Pull API in 3 short steps:
- Request an Authorization Token
Send an email to your contact at Hotel Trader for a token request. - Start developing using our QA environment
For more details please see Sandbox Endpoints And Credentials. - Get Certified
Once you complete development, please get in touch with the Hotel Trader Team to get certified. Details about the certification process can be found here.
Developer Resources
A customized URL for all mapping files, including Property, Room, and RegionCode, will be provided to you, before launch. These mapping files are updated in real time and stored in an AWS cloud bin for download. The URLs may be configured in your database as once created they will never change.
Our Recommendation
As you start the development process, Hotel Trader recommends the following search and booking path:
Pre-Booking
The initial search request in the customer journey by PropertyID(s). Hotel Trader's response for a given search will include:
- All available properties
- All available room types and descriptions
- Cheapest Non-Refundable Rate
- Cheapest Refundable Rate
- Taxes
- Amenity/Resort Fees
- Full Cancellation Policy
The confirm price check to validate specific property rates available before booking.
An HT-Identifier will be provided for all rates in the initial search step. This HT-Identifier will be used to retrieve all rates you wish to validate before booking. Hotel Trader will provide the same data fields from the initial search response as applicable.
The final confirmation request to book a previously validated rate. The HT-Identifier for the rate chosen to be booked will be used.
Post-Booking
The cancellation request for a previously booked reservation. Per cancellation policy terms. The HTConfirmationCode will be used in the request.
The modification request for a previously booked reservation. Per modification policy terms. The HTConfirmationCode will be used in the request.
The request for confirmed booking details of a single reservation or a subset of reservations over a given period of time. The HTConfirmationCode(s) and ClientConfirmationCode(s) will be used in the request.
The request for confirmed booking details over a given period of time. The check-in, check-out, and creation dates will be used in the request.
To get a detailed understanding of the Hotel Trader Pull API queries, visit the Queries page.