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

Consulter une réservation de vol

Reads the current status and normalized detail for a flight order created through Travelandz.

Endpoint

Method	Path	Auth
`GET`	`/v1/flights/booking/:gdsprovider/:orderId`	Required API key

Required headers:

Header	Description
`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.

Request Params Schema

Property	Type	Details	Required	Notes
`gdsprovider`	`number`		Yes	-
`orderId`	`string`		Yes	-

Success Response

Returns details of the order

Response Body Schema

Property	Type	Details	Required	Notes
`orderDetails`	`object`		Yes	-
`orderDetailsorderId`	`string`		Yes	-
`orderDetailsgdsprovider`	`number`		Yes	-
`orderDetailsbookingReference`	`string`		Yes	-
`orderDetailsconditions`	`object`		Yes	-
`orderDetailsconditionsrefundBeforeDeparture`	`object`		Yes	-
`orderDetailsconditionsrefundBeforeDeparturecurrency`	`string`		Yes	-
`orderDetailsconditionsrefundBeforeDeparturepenaltyAmount`	`string`		Yes	-
`orderDetailsconditionsrefundBeforeDepartureallowed`	`boolean`		Yes	-
`orderDetailsconditionschangeBeforeDeparture`	`object`		Yes	-
`orderDetailsconditionschangeBeforeDeparturecurrency`	`string`		Yes	-
`orderDetailsconditionschangeBeforeDeparturepenaltyAmount`	`string`		Yes	-
`orderDetailsconditionschangeBeforeDepartureallowed`	`boolean`		Yes	-
`orderDetailssyncedAt`	`string`	`Format: ISO 8601`	Yes	-
`orderDetailsslices`	`array`		Yes	-
`orderDetailsslices[]fareName`	`string`		Yes	-
`orderDetailsslices[]departure`	`object`		Yes	-
`orderDetailsslices[]departureiataCode`	`string`		Yes	-
`orderDetailsslices[]departurecityName`	`string`		Yes	-
`orderDetailsslices[]departureairportName`	`string`		No	-
`orderDetailsslices[]departuredepartingAt`	`string`		No	-
`orderDetailsslices[]departuretimeZone`	`string`		No	-
`orderDetailsslices[]arrival`	`object`		Yes	-
`orderDetailsslices[]arrivaliataCode`	`string`		Yes	-
`orderDetailsslices[]arrivalcityName`	`string`		Yes	-
`orderDetailsslices[]arrivalairportName`	`string`		No	-
`orderDetailsslices[]arrivaldepartingAt`	`string`		No	-
`orderDetailsslices[]arrivaltimeZone`	`string`		No	-
`orderDetailsslices[]segments`	`array`		Yes	-
`orderDetailsslices[]segments[]fareName`	`string`		Yes	-
`orderDetailsslices[]segments[]departure`	`object`		Yes	-
`orderDetailsslices[]segments[]departureiataCode`	`string`		Yes	-
`orderDetailsslices[]segments[]departurecityName`	`string`		Yes	-
`orderDetailsslices[]segments[]departureairportName`	`string`		No	-
`orderDetailsslices[]segments[]departuredepartingAt`	`string`		No	-
`orderDetailsslices[]segments[]departuretimeZone`	`string`		No	-
`orderDetailsslices[]segments[]departureterminal`	`string`		No	-
`orderDetailsslices[]segments[]arrival`	`object`		Yes	-
`orderDetailsslices[]segments[]arrivaliataCode`	`string`		Yes	-
`orderDetailsslices[]segments[]arrivalcityName`	`string`		Yes	-
`orderDetailsslices[]segments[]arrivalairportName`	`string`		No	-
`orderDetailsslices[]segments[]arrivaldepartingAt`	`string`		No	-
`orderDetailsslices[]segments[]arrivaltimeZone`	`string`		No	-
`orderDetailsslices[]segments[]arrivalterminal`	`string`		No	-
`orderDetailsslices[]segments[]airline`	`object`		Yes	-
`orderDetailsslices[]segments[]airlineoperatingCarrier`	`object`		Yes	-
`orderDetailsslices[]segments[]airlineoperatingCarriername`	`string`		Yes	-
`orderDetailsslices[]segments[]airlineoperatingCarrieriataCode`	`string`		Yes	-
`orderDetailsslices[]segments[]airlineoperatingCarrierlogoURL`	`string`		Nullable	-
`orderDetailsslices[]segments[]airlineoperatingCarrierconditionsOfCarriage`	`string`		No	-
`orderDetailsslices[]segments[]airlinemarketingCarrier`	`object`		Yes	-
`orderDetailsslices[]segments[]airlinemarketingCarriername`	`string`		Yes	-
`orderDetailsslices[]segments[]airlinemarketingCarrieriataCode`	`string`		Yes	-
`orderDetailsslices[]segments[]airlinemarketingCarrierlogoURL`	`string`		Nullable	-
`orderDetailsslices[]segments[]airlinemarketingCarrierconditionsOfCarriage`	`string`		No	-
`orderDetailsslices[]segments[]flightNumber`	`string`		Yes	-
`orderDetailsslices[]segments[]durationMinutes`	`number`		Yes	-

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

`orderDetailsdocuments`	`array`		Yes	-
`orderDetailsdocuments[]passengerIds`	`array`		Yes	-
`orderDetailsdocuments[]passengerIds[]`	`string[]`		Yes	-

`orderDetailsdocuments[]type`	`enum`	`electronic_ticketelectronic_miscellaneous_document_associatedelectronic_miscellaneous_document_standalone`	Yes	-
`orderDetailsdocuments[]id`	`string`		Yes	-

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

`orderDetailstotalAmount`	`number`		Yes	-
`orderDetailsofferId`	`string`		No	-

Operational Notes

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.

Example

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"