Booking

The Booking API allows you to book rooms and rates confirmed by the Price Check response.

The primary itinerary method of the Booking API creates a reservation for the selected property, room, rate, and occupancy. Payment information, including billing/cardholder contact information, is provided directly within the request.

Each successful booking response contains links to retrieve the itinerary or cancel the reservation. See our Manage Booking and handling Booking requests sections for details.

To make a multi-room booking (of the same room type) you must first make a Shop request and pass a separate occupancy parameter for each room. Then, in the Book request, include corresponding separate instances of room in the rooms array for each room you wish to book.

To hold inventory for a brief duration before completing a booking (e.g. to build a package), refer to our Hold and Resume documentation.

To make a test booking that will not charge your card or be sent to the property, see our Test Request documentation.

The Booking link from your previous Price Check response expires after a short period. If you receive an HTTP 503 error upon your first attempt, the link has likely expired. Obtain a new link and attempt your booking again.

Tax IDs for INR and BRL bookings

Due to regulatory tax requirements, some Rapid transactions made in Indian Rupees (INR) and Brazilian Real (BRL) require a valid individual tax ID of the paying traveler in the tax_registration_number parameter.

Create Booking requests may fail if this parameter is left blank or an invalid tax ID is provided. Requests will return an HTTP 400 error with a message describing the source of the error as the tax_registration_number. This should be corrected by updating the tax_registration_number to a valid tax ID and re-sending the Create Booking request.

API details

Explore the booking-related endpoint definitions on this page, then use the API Explorer or another testing software to get an understanding of how the examples and schema definitions compare to the actual output.


Additional resources

Whether you're looking to try out all the Rapid API endpoints or to download its OpenAPI specs or our Postman collection, we have you covered.



Did you find this page helpful?
How can we improve this content?
Thank you for helping us improve!