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 section and Handling booking requests page for details.
To make a multi-room booking (of the same room type), you must first make a Shopping API request and pass a separate occupancy parameter for each room. Then, in the Booking 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.
Booking link expiration
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 API 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.
Requests from the Create Booking API 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.
Sanctions
Sanctions are economic and trade restrictions against blocked parties. The UN has 30 sanctions regimes, including those in Iraq, Iran, Sudan, Yemen, and against ISIL, Al-Qaida, and the Taliban. The US, EU, and UK also have their own sanctions targeting terrorists, narcotics traffickers, and threats to national security. Companies incorporated in the US, EU, or any UN member country must comply with these sanctions.
How dooes Rapid ensure compliance with sanctions?
We have added the ability for you to capture additional details about the traveler at the time of booking, including their date of birth, full name, and address. These details are then ingested into the case management tool used by our Fraud and Risk Team for sanctions screening.
Additional fields for sanctions screening can be found under sensitive_traveler_details in the Create Booking schema. This feature will be ready for adoption from January 2026.
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.