Destinations
What is the Destinations Query?β
The Destinations Query provides a list of destinations from a supplierβs access, allowing Buyers to retrieve all destinations configured for a given set of credentials.
Check out our Hotel-X Pull Buyers API Documentation for a complete example of a Destinations Query! π
What Information is Included in the Destinations Query Response?β
The response typically includes the following fields:
- Code β The Sellerβs destination code.
- Available β Indicates if the destination is available.
- DestinationLeaf β Specifies whether the destination is a final node in the hierarchy.
- Texts β Contains descriptions of the destination.
- ClosestDestinations β Lists nearby destinations.
- Parent β Indicates the parent destination in the hierarchy.
- Type β Specifies whether the destination is a zone or a city.
Understanding Destination List Logicβ
How Are Destinations Categorized?β
When you run a Destinations Query, the Seller's native destination codes are classified into two categories:
- Zone
- City
How Should I Use Zone and City Nodes in the Response?β
Suppliers structure their Destination Tree using both zone and city nodes. When you request their destination list, the response is categorized to facilitate the mapping process.
The amount of information, content, and categorization of destinations may vary across Sellers.
For example, one Seller might classify San Francisco as a "Zone," while another may categorize it as a "City."
Destination Mapping and Filteringβ
What Destination Codes Should I Map as a Buyer?β
The destinations you choose to map depend on your business needs. If you're only interested in specific locations, you can filter them accordingly.
For example, if you're focused on Spanish destinations, you can filter the Destinations Query using the "destinationCodes" field with the value "ES", ensuring that only Spanish destinations are included in the response.
How Can I Determine the Total Number of Destinations Provided by a Seller?β
To retrieve the complete list of destinations, you need to use pagination.
By utilizing the token provided in each response, you can fetch subsequent sets of destinations. When you encounter an error message stating "destinations not found," it indicates that the entire list has been retrieved.
Availability Considerationsβ
Will All Destinations in the List Have Availability?β
No, the inclusion of a destination in the list does not guarantee hotel availability in that location.
To verify hotel availability, you should:
- Perform a Search Query to check hotel availability for your desired dates.
- Reach out to the Seller to inquire about the current availability of destinations and properties.
Explore our Documentation to learn more about Destinations Query with detailed examples! ππ