BookingGet
Endpoint
Section titled “Endpoint”GET {base_url}/1.0/bookings/{bookingId}Retrieve full details of a previously-created booking.
Headers
Section titled “Headers”| Header | Value |
|---|---|
Authorization |
Bearer <access_token> |
Accept |
application/json |
Path parameter
Section titled “Path parameter”| 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.
Response
Section titled “Response”{ "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"}Response fields
Section titled “Response fields”| 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.
Errors
Section titled “Errors”| 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 |
Use cases
Section titled “Use cases”- 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
cancellationPoliciesbefore callingBookingDeleteto inform the user of penalty.
Important behavior
Section titled “Important behavior”cancellationPoliciesmay be[]after the cancellation window has passed.- A booking with
status: CANCELLEDstill returns full details — checkstatusfirst.

