Retrieves detailed booking information for a specific booking using the trace ID. Returns itinerary details, guest information, hotel static content, and booking status. This endpoint has the same response structure as the booking details by booking code endpoint.
Note: For this endpoint, please select the Helper API's Sandbox or Production server from the dropdown in the Base URL panel.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
In case, the connection may drop while a booking is being created before the bookingCode reaches the Merchant. In this situation, do not retry the book — call below cURL to fetch the current status of that booking attempt instead.
curl --location '{{host_url}}/api/v1/hotels/itineraries/bookings/status/{{traceId}}' \
--header 'Authorization: {{token}}' \
--header 'Authorization-Type: external-service' \
--header 'source: website' \
--header 'Authorization-mode: AWSCognito'This API can only be called within 30 minutes of the original booking creation attempt.
After 30 minutes, the API will no longer return the status, and you'll instead receive:
{
"message": "Internal Server Error. Please Try Again.",
"httpStatusCode": 500,
"error": {
"code": 1058,
"message": "The api /itineraries/bookings/status/<traceId> that you have called is unable to return data. Please raise a request with [email protected]",
"traceId": "<traceId>"
}
}If this window has passed, do not attempt to resolve it via API — raise a query with the actual booking details (trace id, guest names & search criteria) to [email protected] to get the current booking status manually.
Bad Request. One or more request parameters are invalid or missing.
Unauthorized - Invalid or missing token
Forbidden - Insufficient permissions
Not Found. The requested resource could not be located.
Internal server error