Pular para o conteúdo

BookingReservations

POST {base_url}/1.0/bookings/reservations

Lista as reservas criadas em um intervalo de datas, com um resumo de cada uma.

Header Valor
Authorization Bearer <access_token>
Content-Type application/json
Accept application/json
{
"createdRange": {
"from": "2026-04-13",
"to": "2026-04-16"
}
}
Campo Tipo Descrição
createdRange object Intervalo de datas de criação da reserva
createdRange.from string Início do intervalo, YYYY-MM-DD
createdRange.to string Fim do intervalo, YYYY-MM-DD

Em uma amostra, o intervalo foi aplicado à data de criação da reserva, não à data de check-in.

{
"reservations": [
{
"id": 21204517,
"status": "CONFIRMED",
"dateSale": "2026-04-14T09:12:45.317",
"checkIn": "2027-05-15T00:00:00",
"clientReference": "10045",
"clientName": "John",
"clientSurname": "Smith",
"hotelId": 100652,
"hotelName": "Ocean View Cancun Arenas"
},
{
"id": 21204688,
"status": "CANCELLED",
"dateSale": "2026-04-15T16:03:08.25",
"checkIn": "2027-05-15T00:00:00",
"clientReference": "10046",
"clientName": "Maria",
"clientSurname": "Lopez",
"hotelId": 100652,
"hotelName": "Ocean View Cancun Arenas"
}
],
"eventId": "5b8e2f41-9a7c-4d3e-b1f6-2c0d8a9e7f13"
}

Este exemplo é ilustrativo, não uma captura: segue a forma de uma resposta observada, e seus valores não são reais.

Campo Tipo Notas
reservations array Reservas criadas no intervalo
reservations[].id int ID da reserva
reservations[].status string Status da reserva. Em uma amostra de seis entradas: CONFIRMED em quatro e CANCELLED em duas. Não assuma que são os únicos valores.
reservations[].dateSale string Data e hora da venda, sem designador de fuso horário. Em uma amostra de seis entradas, a fração de segundos teve três dígitos em quatro entradas, dois em uma e um em uma. Não assuma um número fixo de dígitos.
reservations[].checkIn string Data e hora do check-in, sem fração de segundos nem designador de fuso horário, nas seis entradas de uma amostra
reservations[].clientReference string Referência do parceiro
reservations[].clientName string Nome do titular
reservations[].clientSurname string Sobrenome do titular
reservations[].hotelId int ID do hotel
reservations[].hotelName string Nome do hotel
eventId string ID de rastreamento

Cada entrada é um resumo: não inclui check-out, valor, moeda, quartos nem políticas de cancelamento. Para esses detalhes, use o BookingGet.

Código HTTP Mensagem Causa O que fazer
6102 400 Invalid range, only 31 days are allowed A mensagem indica que o intervalo não é válido e informa um número de dias permitidos; como os dias são contados não está definido. Reduza o intervalo ou divida o período em várias requisições.

Em uma amostra, um intervalo em que to caía 30 dias depois de from foi aceito, e um em que to caía 31 dias depois de from foi rejeitado com 6102. Como os dias são contados não está definido.

Os demais códigos de erro próprios deste endpoint não estão documentados. Para os códigos comuns a todos os endpoints, ver Error codes.

  • Listar as reservas criadas em um intervalo de datas. A lista pode incluir reservas canceladas: verifique o status de cada entrada.
  • Conferir as reservas com seus próprios registros usando o clientReference, filtrando a lista do seu lado.
  • Solicite o intervalo mais estreito que cubra o que você precisa.
  • Evite intervalos amplos e polling deste endpoint.