GET/v1/flights/booking/:gdsprovider/:orderId

Consultar reserva de vuelo

Consulta el estado actual y el detalle normalizado de una orden de vuelo creada mediante Travelandz.

Endpoint

Método	Ruta	Auth
`GET`	`/v1/flights/booking/:gdsprovider/:orderId`	API key requerida

Headers obligatorios:

Header	Descripción
`Authorization`	`Bearer <secret_key>`. The secret is shown only once when the credential is created.
`X-Travelandz-Id`	`<public_key>:<profile_code>`. The `profile_code` is the `dp_`-prefixed Developer Profile code shown in your dashboard. This binds the request to a profile and credential.
`Content-Type`	Use `application/json` for requests with a body.

Esquema de parámetros de la petición

Propiedad	Tipo	Detalles	Requerido	Notas
`gdsprovider`	`number`		Sí	-
`orderId`	`string`		Sí	-

Respuesta exitosa

Devuelve details of the order

Esquema del cuerpo de la respuesta

Propiedad	Tipo	Detalles	Requerido	Notas
`orderDetails`	`object`		Sí	-
`orderDetailsorderId`	`string`		Sí	-
`orderDetailsgdsprovider`	`number`		Sí	-
`orderDetailsbookingReference`	`string`		Sí	-
`orderDetailsconditions`	`object`		Sí	-
`orderDetailsconditionsrefundBeforeDeparture`	`object`		Sí	-
`orderDetailsconditionsrefundBeforeDeparturecurrency`	`string`		Sí	-
`orderDetailsconditionsrefundBeforeDeparturepenaltyAmount`	`string`		Sí	-
`orderDetailsconditionsrefundBeforeDepartureallowed`	`boolean`		Sí	-
`orderDetailsconditionschangeBeforeDeparture`	`object`		Sí	-
`orderDetailsconditionschangeBeforeDeparturecurrency`	`string`		Sí	-
`orderDetailsconditionschangeBeforeDeparturepenaltyAmount`	`string`		Sí	-
`orderDetailsconditionschangeBeforeDepartureallowed`	`boolean`		Sí	-
`orderDetailssyncedAt`	`string`	`Format: ISO 8601`	Sí	-
`orderDetailsslices`	`array`		Sí	-
`orderDetailsslices[]fareName`	`string`		Sí	-
`orderDetailsslices[]departure`	`object`		Sí	-
`orderDetailsslices[]departureiataCode`	`string`		Sí	-
`orderDetailsslices[]departurecityName`	`string`		Sí	-
`orderDetailsslices[]departureairportName`	`string`		No	-
`orderDetailsslices[]departuredepartingAt`	`string`		No	-
`orderDetailsslices[]departuretimeZone`	`string`		No	-
`orderDetailsslices[]arrival`	`object`		Sí	-
`orderDetailsslices[]arrivaliataCode`	`string`		Sí	-
`orderDetailsslices[]arrivalcityName`	`string`		Sí	-
`orderDetailsslices[]arrivalairportName`	`string`		No	-
`orderDetailsslices[]arrivaldepartingAt`	`string`		No	-
`orderDetailsslices[]arrivaltimeZone`	`string`		No	-
`orderDetailsslices[]segments`	`array`		Sí	-
`orderDetailsslices[]segments[]fareName`	`string`		Sí	-
`orderDetailsslices[]segments[]departure`	`object`		Sí	-
`orderDetailsslices[]segments[]departureiataCode`	`string`		Sí	-
`orderDetailsslices[]segments[]departurecityName`	`string`		Sí	-
`orderDetailsslices[]segments[]departureairportName`	`string`		No	-
`orderDetailsslices[]segments[]departuredepartingAt`	`string`		No	-
`orderDetailsslices[]segments[]departuretimeZone`	`string`		No	-
`orderDetailsslices[]segments[]departureterminal`	`string`		No	-
`orderDetailsslices[]segments[]arrival`	`object`		Sí	-
`orderDetailsslices[]segments[]arrivaliataCode`	`string`		Sí	-
`orderDetailsslices[]segments[]arrivalcityName`	`string`		Sí	-
`orderDetailsslices[]segments[]arrivalairportName`	`string`		No	-
`orderDetailsslices[]segments[]arrivaldepartingAt`	`string`		No	-
`orderDetailsslices[]segments[]arrivaltimeZone`	`string`		No	-
`orderDetailsslices[]segments[]arrivalterminal`	`string`		No	-
`orderDetailsslices[]segments[]airline`	`object`		Sí	-
`orderDetailsslices[]segments[]airlineoperatingCarrier`	`object`		Sí	-
`orderDetailsslices[]segments[]airlineoperatingCarriername`	`string`		Sí	-
`orderDetailsslices[]segments[]airlineoperatingCarrieriataCode`	`string`		Sí	-
`orderDetailsslices[]segments[]airlineoperatingCarrierlogoURL`	`string`		Nulable	-
`orderDetailsslices[]segments[]airlineoperatingCarrierconditionsOfCarriage`	`string`		No	-
`orderDetailsslices[]segments[]airlinemarketingCarrier`	`object`		Sí	-
`orderDetailsslices[]segments[]airlinemarketingCarriername`	`string`		Sí	-
`orderDetailsslices[]segments[]airlinemarketingCarrieriataCode`	`string`		Sí	-
`orderDetailsslices[]segments[]airlinemarketingCarrierlogoURL`	`string`		Nulable	-
`orderDetailsslices[]segments[]airlinemarketingCarrierconditionsOfCarriage`	`string`		No	-
`orderDetailsslices[]segments[]flightNumber`	`string`		Sí	-
`orderDetailsslices[]segments[]durationMinutes`	`number`		Sí	-

`orderDetailspassengers`	`array`		Sí	-
`orderDetailspassengers[]type`	`enum`	`adultchildinfant_without_seat`	Sí	-
`orderDetailspassengers[]title`	`enum`	`mrmsmrsmiss`	Sí	-
`orderDetailspassengers[]phoneNumber`	`string`		Sí	-
`orderDetailspassengers[]infantPassengerId`	`string`		No	-
`orderDetailspassengers[]id`	`string`		Sí	-
`orderDetailspassengers[]firstName`	`string`		Sí	-
`orderDetailspassengers[]gender`	`enum`	`mf`	Sí	-
`orderDetailspassengers[]lastName`	`string`		Sí	-
`orderDetailspassengers[]email`	`string`		Sí	-
`orderDetailspassengers[]bornOn`	`string`		Sí	-
`orderDetailspassengers[]tickets`	`array`		Sí	-
`orderDetailspassengers[]tickets[]ticketNumber`	`string`		Sí	-
`orderDetailspassengers[]tickets[]status`	`enum`	`booking-in-progressticket-in-progressticketed`	Nulable	-
`orderDetailspassengers[]tickets[]type`	`enum`	`ElectronicElectronic Miscellaneous Document – AssociatedElectronic Miscellaneous Document – Standalone`	Sí	ET, EMD-A, EMD-S

`orderDetailsdocuments`	`array`		Sí	-
`orderDetailsdocuments[]passengerIds`	`array`		Sí	-
`orderDetailsdocuments[]passengerIds[]`	`string[]`		Sí	-

`orderDetailsdocuments[]type`	`enum`	`electronic_ticketelectronic_miscellaneous_document_associatedelectronic_miscellaneous_document_standalone`	Sí	-
`orderDetailsdocuments[]id`	`string`		Sí	-

`orderDetailsbookingReferences`	`array`		Sí	-
`orderDetailsbookingReferences[]reference`	`string`		Sí	-
`orderDetailsbookingReferences[]airline`	`object`		Sí	-
`orderDetailsbookingReferences[]airlineoperatingCarrier`	`object`		Sí	-
`orderDetailsbookingReferences[]airlineoperatingCarriername`	`string`		Sí	-
`orderDetailsbookingReferences[]airlineoperatingCarrieriataCode`	`string`		Sí	-
`orderDetailsbookingReferences[]airlineoperatingCarrierlogoURL`	`string`		Nulable	-
`orderDetailsbookingReferences[]airlineoperatingCarrierconditionsOfCarriage`	`string`		No	-
`orderDetailsbookingReferences[]airlinemarketingCarrier`	`object`		Sí	-
`orderDetailsbookingReferences[]airlinemarketingCarriername`	`string`		Sí	-
`orderDetailsbookingReferences[]airlinemarketingCarrieriataCode`	`string`		Sí	-
`orderDetailsbookingReferences[]airlinemarketingCarrierlogoURL`	`string`		Nulable	-
`orderDetailsbookingReferences[]airlinemarketingCarrierconditionsOfCarriage`	`string`		No	-

`orderDetailstotalAmount`	`number`		Sí	-
`orderDetailsofferId`	`string`		No	-

Notas operativas

The response detail can vary by source.
Some booking responses can return passengers and tickets without flight slices. When the order was created after a public search, Travelandz enriches slices, conditions and offerId from the tracked parsed offer.
If no tracked offer snapshot exists, the endpoint returns the available provider detail without failing only because slices are missing.

Ejemplo

bash

curl https://api.sandbox.travelandz.com/v1/flights/booking/1/order_123 \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE"