Skip to content

BookingGet

GET {base_url}/1.0/bookings/{bookingId}

Retrieve full details of a previously-created booking.

Header Value
Authorization Bearer <access_token>
Accept application/json
Param Type Description
bookingId int Numeric booking ID returned by BookingNew. clientReference cannot be used in this path.

The API does not provide a booking lookup by clientReference: it cannot replace bookingId, and GET /1.0/bookings?clientReference=... is not an available route.

{
"id": 21198221,
"status": "CONFIRMED",
"hotels": [
{
"checkIn": "2027-05-15",
"checkOut": "2027-05-16",
"confirmationCode": "",
"id": 100652,
"name": "Ocean View Cancun Arenas",
"rooms": [
{
"roomName": "Standard",
"mealPlan": "All Inclusive",
"occupancy": {
"adults": 2,
"childrenAges": []
},
"primaryGuest": "Jane Doe"
}
]
}
],
"amount": 116.00,
"taxes": 16.00,
"currency": "USD",
"clientReference": "99999",
"client": {
"name": "Jane",
"surname": "Doe",
"contactData": [
{
"email": "jane.doe@example.com",
"phone": { "countryCode": "+52", "number": "5512312322" }
}
]
},
"dateSale": "2026-04-15T10:30:00Z",
"cancellationPolicies": [],
"eventId": "c3eb536d-6378-4f2f-a922-b231de1ecd47"
}
Field Type Notes
id int Booking ID
status string CONFIRMED, CREATED, or CANCELLED
hotels[].checkIn string Stay start date — see the note below
hotels[].checkOut string Stay end date — see the note below
hotels[].confirmationCode string Hotel confirmation code. It is an empty string while unavailable, including when the booking status is CONFIRMED.
hotels[].id int Hotel ID
hotels[].name string Hotel name
hotels[].rooms array Rooms in the booking
hotels[].rooms[].roomName string Room name
hotels[].rooms[].mealPlan string Meal-plan description — see the note below
hotels[].rooms[].occupancy object Room occupancy
hotels[].rooms[].occupancy.adults int Number of adults
hotels[].rooms[].occupancy.childrenAges int[] Children’s ages
hotels[].rooms[].primaryGuest string Primary guest name — see the note below
amount float Total charged
taxes float Tax portion of amount
currency string Currency code
clientReference string Partner reference. It cannot be used to look up a booking through the API.
client.* object Holder details
dateSale string When the sale was completed — see the note below
cancellationPolicies array Penalty windows (post-confirmation)
eventId string Trace ID. Do not treat it as unique per request — see BookingNew

Observed mealPlan values are meal-plan descriptions, such as Room Only or Continental breakfast, not codes. Do not treat mealPlan as a code.

In two responses, primaryGuest contained the booking holder’s first and last name from client. In a response where pax names had been sent in HotelRates (roomCriteria[].paxes[].name / surname), those names were not reflected. Do not expect them to be returned by BookingGet. In a response where roomCriteria had been sent in BookingHold, the primaryGuest of each room was the first pax of that room (one sample). See Guest data in the hold.

A successful BookingGet response may omit the error property; do not require it.

Code HTTP Message Cause What to do
201 500 Invalid booking id / reservation number. Only numbers are allowed The bookingId in the path is not numeric Send the numeric bookingId
1201 500 The itinerary does not contain valid services Booking corrupt or partner setup issue Contact PriceTravel with the request, the response, and the eventId
1202 500 Locator’s not found for the requested channel Booking not visible from this channel Check the bookingId; if it is correct, contact PriceTravel with the request, the response, and the eventId
  • Check a booking’s status after a timeout or 5xx on BookingNew, when you have its bookingId — see the retry strategy in BookingNew.
  • Show booking details on partner UI.
  • Read cancellationPolicies before calling BookingDelete to inform the user of penalty.
  • cancellationPolicies may be [] after the cancellation window has passed.
  • A booking with status: CANCELLED still returns full details — check status first.