BookingGet
Endpoint
Seção intitulada “Endpoint”GET {base_url}/1.0/bookings/{bookingId}Recupera os detalhes completos de uma reserva criada anteriormente.
Headers
Seção intitulada “Headers”| Header | Valor |
|---|---|
Authorization |
Bearer <access_token> |
Accept |
application/json |
Parâmetro de rota
Seção intitulada “Parâmetro de rota”| Parâmetro | Tipo | Descrição |
|---|---|---|
bookingId |
int | ID numérico da reserva retornado pelo BookingNew. Não é possível usar clientReference nesta rota. |
A API não permite localizar uma reserva por clientReference: ele não substitui o bookingId, e GET /1.0/bookings?clientReference=... não é uma rota disponível.
Resposta
Seção intitulada “Resposta”{ "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"}Campos da resposta
Seção intitulada “Campos da resposta”| Campo | Tipo | Notas |
|---|---|---|
id |
int | ID da reserva |
status |
string | CONFIRMED, CREATED ou CANCELLED |
hotels[].checkIn |
string | Data de início da estadia — ver a nota abaixo |
hotels[].checkOut |
string | Data de fim da estadia — ver a nota abaixo |
hotels[].confirmationCode |
string | Número de confirmação do hotel. É uma string vazia enquanto não estiver disponível, inclusive quando o status da reserva for CONFIRMED. |
hotels[].id |
int | ID do hotel |
hotels[].name |
string | Nome do hotel |
hotels[].rooms |
array | Quartos da reserva |
hotels[].rooms[].roomName |
string | Nome do quarto |
hotels[].rooms[].mealPlan |
string | Descrição do plano de refeições — ver a nota abaixo |
hotels[].rooms[].occupancy |
object | Ocupação do quarto |
hotels[].rooms[].occupancy.adults |
int | Número de adultos |
hotels[].rooms[].occupancy.childrenAges |
int[] | Idades das crianças |
hotels[].rooms[].primaryGuest |
string | Nome do hóspede principal — ver a nota abaixo |
amount |
float | Total cobrado |
taxes |
float | Parcela de impostos do valor |
currency |
string | Código de moeda |
clientReference |
string | Referência do parceiro. Não permite localizar uma reserva pela API. |
client.* |
object | Dados do titular |
dateSale |
string | Quando a venda foi concluída — ver a nota abaixo |
cancellationPolicies |
array | Janelas de penalidade (pós-confirmação) |
eventId |
string | ID de rastreamento. Não o trate como único por requisição — ver BookingNew |
Os valores observados de mealPlan são descrições do plano de refeições, como Room Only ou Continental breakfast, não códigos. Não trate mealPlan como um código.
Em duas respostas, primaryGuest continha o nome e o sobrenome do titular da reserva obtidos de client. Em uma resposta na qual haviam sido enviados nomes de pax no HotelRates (roomCriteria[].paxes[].name / surname), esses nomes não foram refletidos. Não espere que o BookingGet os retorne. Em uma resposta na qual havia sido enviado roomCriteria no BookingHold, o primaryGuest de cada quarto foi o primeiro hóspede desse quarto (uma amostra). Ver Guest data in the hold.
Uma resposta bem-sucedida do BookingGet pode omitir a propriedade error; não a exija.
| Código | HTTP | Mensagem | Causa | O que fazer |
|---|---|---|---|---|
| 201 | 500 | Invalid booking id / reservation number. Only numbers are allowed | O bookingId na rota não é numérico |
Envie o bookingId numérico |
| 1201 | 500 | The itinerary does not contain valid services | Reserva corrompida ou problema de configuração do parceiro | Contate a PriceTravel com a requisição, a resposta e o eventId |
| 1202 | 500 | Locator’s not found for the requested channel | Reserva não visível a partir deste channel | Verifique o bookingId; se estiver correto, contate a PriceTravel com a requisição, a resposta e o eventId |
Casos de uso
Seção intitulada “Casos de uso”- Consultar o status de uma reserva após um timeout ou 5xx no BookingNew, quando você tem o
bookingIdda reserva — ver a estratégia de retentativa em BookingNew. - Exibir os detalhes da reserva na UI do parceiro.
- Ler
cancellationPoliciesantes de chamar oBookingDeletepara informar o usuário sobre a penalidade.
Comportamento importante
Seção intitulada “Comportamento importante”cancellationPoliciespode ser[]depois que a janela de cancelamento passou.- Uma reserva com
status: CANCELLEDainda retorna os detalhes completos — verifique ostatusprimeiro.

