Each step returns an ID, or a set of IDs you can choose from to move to the next step.
1. Search for an accommodation
There are four important things to provide when searching for available accommodation:
Number of guests
Number of rooms
Check in and Check out dates
Search Location (Latitude and Longitude, with a coverage radius in kilometres) or accommodation IDs to search for
Our endpoint will return a list of search results, each with its own accommodation. Select the search result with the desired available accommodation. It is important to note that the search_result_id of this search result is required in the next step.
We will only return available accommodation that matches your search criteria. It’s expected that a search result’s accommodation may not include rooms and rates information provided at this stage in the flow, but you will always know the cheapest rate.
2. Retrieve all available room rates for your chosen result
Using the search_result_id for the desired accommodation from the previous step, we can use the fetch all rates endpoint to retrieve all available rooms and rates for that result.
An accommodation can have multiple room options, and rooms in turn can have various rates. The rate for a room varies in price depending on what’s included. For example, the same room can be purchased through a rate that comes with or without breakfast or is non-refundable or fully refundable.
We need to take note of the desired rate_id in order to move to the next step.