Pular para o conteúdo

BookingGet

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

Recupera os detalhes completos de uma reserva criada anteriormente.

Header Valor
Authorization Bearer <access_token>
Accept application/json
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.

{
"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"
}
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
  • Consultar o status de uma reserva após um timeout ou 5xx no BookingNew, quando você tem o bookingId da reserva — ver a estratégia de retentativa em BookingNew.
  • Exibir os detalhes da reserva na UI do parceiro.
  • Ler cancellationPolicies antes de chamar o BookingDelete para informar o usuário sobre a penalidade.
  • cancellationPolicies pode ser [] depois que a janela de cancelamento passou.
  • Uma reserva com status: CANCELLED ainda retorna os detalhes completos — verifique o status primeiro.