Skip to navigation
Hotel APIHotels

Get reservation details

Retrieves a detailed reservation summary and status of a traveler reservation.

Use case

This endpoint can be used after booking on a reservation summary page to provide users with hotel and reservation information most relevant to their upcoming reservation. It must also be used by your application to check the status of a reservation until it is fully completed, or your application receives an error. The response contains the most relevant summary information of a reservation, including rate details, basic hotel information, cancellation policy, location, and traveler and payment information with masked credit card.

What’s next?

This is the last step of the booking application workflow.

Path parameters

versionstringRequired

Headers

AuthorizationstringOptional

Request signature for authentication. Format: Signature YOUR_SIGNATURE. Calculated using HMAC-SHA256 with your secret key.

Query parameters

api_keystringOptional

Your public API key. Example: api_key=testkey.

timestampstringOptional

The UNIX (UTC) timestamp created by your application for this request (in seconds). Must be within 2.5 minutes of the current time.

noncestringOptional
A unique cryptographic identifier created by your application to secure the request. Must be 32 characters or less and cannot be reused within 5 minutes.
localestringOptional

The language preference of your user. Valid values: en_US, fr_FR, de_DE, es_ES, it_IT, pt_PT, ja_JP, ko_KR. Default is en_US.

customer_ipstringOptional
The IP address of your user. Allows determination of the user's location for fraud recovery and analytics purposes.
session_idstringOptional
A unique user session identifier created by your application. Do not use the real user's session identifier. Allows identification of all requests throughout a user session for error handling and troubleshooting.
user_agentstringOptional

The user agent (device, application or browser) of your user. Allows retrieval of mobile rates and discounts from some providers. Must be properly encoded. Max 32 characters. Required to get discounted mobile rates.

systemstringOptional

The booking channel. Valid values include: aft, obt, web.

traveler_emailstringOptional
booking_uidstringOptional