GET/v1/flights/booking/:gdsprovider/:orderId
API console
Try it
Send a real request to the sandbox API and inspect the response.
Credentials
Log in to pick from your saved API keys instead of pasting them.
Path parameters
2 fieldsGDS provider
Global Distribution System used to source flight content. Select 0 for the default provider.
Order ID
Identifier of the order returned when the booking was created.
cURL request
bash
curl -X GET 'https://api.sandbox.travelandz.com/v1/flights/booking/0/:orderId' \
-H 'Authorization: Bearer YOUR_SECRET_KEY' \
-H 'X-Travelandz-Id: YOUR_PUBLIC_KEY:YOUR_PROFILE_CODE'Add your credentials to send a request.
Response
Click "Try it!" to send a request and see the response here.
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 |
| 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
gdsproviderorderIdRequest Body
No request body is required.
Success Response
Returns details of the order
Response Body Schema
orderDetailsorderDetailsorderIdorderDetailsgdsproviderorderDetailsbookingReferenceorderDetailsconditionsorderDetailsconditionsrefundBeforeDepartureorderDetailsconditionsrefundBeforeDeparturecurrencyorderDetailsconditionsrefundBeforeDeparturepenaltyAmountorderDetailsconditionsrefundBeforeDepartureallowedorderDetailsconditionschangeBeforeDepartureorderDetailsconditionschangeBeforeDeparturecurrencyorderDetailsconditionschangeBeforeDeparturepenaltyAmountorderDetailsconditionschangeBeforeDepartureallowedorderDetailssyncedAtorderDetailsslicesorderDetailsslices[]fareNameorderDetailsslices[]departureorderDetailsslices[]departureiataCodeorderDetailsslices[]departurecityNameorderDetailsslices[]departureairportNameorderDetailsslices[]departuredepartingAtorderDetailsslices[]departuretimeZoneorderDetailsslices[]arrivalorderDetailsslices[]arrivaliataCodeorderDetailsslices[]arrivalcityNameorderDetailsslices[]arrivalairportNameorderDetailsslices[]arrivaldepartingAtorderDetailsslices[]arrivaltimeZoneorderDetailsslices[]segmentsorderDetailsslices[]segments[]fareNameorderDetailsslices[]segments[]departureorderDetailsslices[]segments[]departureiataCodeorderDetailsslices[]segments[]departurecityNameorderDetailsslices[]segments[]departureairportNameorderDetailsslices[]segments[]departuredepartingAtorderDetailsslices[]segments[]departuretimeZoneorderDetailsslices[]segments[]departureterminalorderDetailsslices[]segments[]arrivalorderDetailsslices[]segments[]arrivaliataCodeorderDetailsslices[]segments[]arrivalcityNameorderDetailsslices[]segments[]arrivalairportNameorderDetailsslices[]segments[]arrivaldepartingAtorderDetailsslices[]segments[]arrivaltimeZoneorderDetailsslices[]segments[]arrivalterminalorderDetailsslices[]segments[]airlineorderDetailsslices[]segments[]airlineoperatingCarrierorderDetailsslices[]segments[]airlineoperatingCarriernameorderDetailsslices[]segments[]airlineoperatingCarrieriataCodeorderDetailsslices[]segments[]airlineoperatingCarrierlogoURLorderDetailsslices[]segments[]airlineoperatingCarrierconditionsOfCarriageorderDetailsslices[]segments[]airlinemarketingCarrierorderDetailsslices[]segments[]airlinemarketingCarriernameorderDetailsslices[]segments[]airlinemarketingCarrieriataCodeorderDetailsslices[]segments[]airlinemarketingCarrierlogoURLorderDetailsslices[]segments[]airlinemarketingCarrierconditionsOfCarriageorderDetailsslices[]segments[]flightNumberorderDetailsslices[]segments[]durationMinutesorderDetailspassengersorderDetailspassengers[]typeorderDetailspassengers[]titleorderDetailspassengers[]phoneNumberorderDetailspassengers[]infantPassengerIdorderDetailspassengers[]idorderDetailspassengers[]firstNameorderDetailspassengers[]genderorderDetailspassengers[]lastNameorderDetailspassengers[]emailorderDetailspassengers[]bornOnorderDetailspassengers[]ticketsorderDetailspassengers[]tickets[]ticketNumberorderDetailspassengers[]tickets[]statusorderDetailspassengers[]tickets[]typeET, EMD-A, EMD-S
orderDetailsdocumentsorderDetailsdocuments[]passengerIdsorderDetailsdocuments[]passengerIds[]orderDetailsdocuments[]typeorderDetailsdocuments[]idorderDetailsbookingReferencesorderDetailsbookingReferences[]referenceorderDetailsbookingReferences[]airlineorderDetailsbookingReferences[]airlineoperatingCarrierorderDetailsbookingReferences[]airlineoperatingCarriernameorderDetailsbookingReferences[]airlineoperatingCarrieriataCodeorderDetailsbookingReferences[]airlineoperatingCarrierlogoURLorderDetailsbookingReferences[]airlineoperatingCarrierconditionsOfCarriageorderDetailsbookingReferences[]airlinemarketingCarrierorderDetailsbookingReferences[]airlinemarketingCarriernameorderDetailsbookingReferences[]airlinemarketingCarrieriataCodeorderDetailsbookingReferences[]airlinemarketingCarrierlogoURLorderDetailsbookingReferences[]airlinemarketingCarrierconditionsOfCarriageorderDetailstotalAmountorderDetailsofferIdliveModeTrue when the request is served by the live Travelandz environment. This value comes from Travelandz, not the provider payload.
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,conditionsandofferIdfrom 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"Responses
| Code | Description |
|---|---|
200 | Flight booking detail retrieved successfully. |
400 | Bad request – invalid payload. |
401 | Unauthorized – invalid or missing credentials. |
403 | Forbidden – invalid credentials. |
500 | Internal server error |
200 Response Body
Media type: application/json
json
{
"orderDetails": {
"orderId": "ord_0000B7aw6DtypHDaOdA5hV",
"gdsprovider": 0,
"bookingReference": "YIYLIU",
"conditions": {
"refundBeforeDeparture": {
"currency": "EUR",
"penaltyAmount": "40.00",
"allowed": true
},
"changeBeforeDeparture": {
"currency": null,
"penaltyAmount": null,
"allowed": false
}
},
"syncedAt": "2026-06-22T14:59:40.000Z",
"slices": [
{
"fareName": "Basic",
"departure": {
"iataCode": "MAD",
"cityName": "Madrid",
"airportName": "Adolfo Suarez Madrid-Barajas Airport",
"departingAt": "2026-08-12T08:30:00",
"timeZone": "Europe/Madrid"
},
"arrival": {
"iataCode": "JFK",
"cityName": "New York",
"airportName": "John F. Kennedy International Airport",
"arrivingAt": "2026-08-12T10:45:00",
"timeZone": "America/New_York"
},
"durationMinutes": 495,
"segments": [
{
"fareName": "Basic",
"departure": {
"iataCode": "MAD",
"cityName": "Madrid",
"airportName": "Adolfo Suarez Madrid-Barajas Airport",
"departingAt": "2026-08-12T08:30:00",
"timeZone": "Europe/Madrid"
},
"arrival": {
"iataCode": "JFK",
"cityName": "New York",
"airportName": "John F. Kennedy International Airport",
"arrivingAt": "2026-08-12T10:45:00",
"timeZone": "America/New_York"
},
"airline": {
"operatingCarrier": {
"name": "Duffel Airways",
"iataCode": "ZZ",
"logoURL": "http://localhost:5000/v1/assets/airlines/0/for-light-background/full-color-logo/ZZ.svg",
"conditionsOfCarriage": "https://duffelairways.com/dummy-url/conditions-of-carriage"
},
"marketingCarrier": {
"name": "Duffel Airways",
"iataCode": "ZZ",
"logoURL": "http://localhost:5000/v1/assets/airlines/0/for-light-background/full-color-logo/ZZ.svg",
"conditionsOfCarriage": "https://duffelairways.com/dummy-url/conditions-of-carriage"
}
},
"flightNumber": "6652",
"durationMinutes": 495
}
]
}
],
"passengers": [
{
"type": "adult",
"title": "mr",
"phoneNumber": "+573128837058",
"infantPassengerId": null,
"id": "pas_0000B7avhgfVejj9UCTZhq",
"gender": "m",
"firstName": "Alejandro",
"lastName": "Toledo",
"email": "jairotoledo2003@gmail.com",
"bornOn": "2003-08-14",
"tickets": [
{
"ticketNumber": "1",
"status": "ticketed",
"type": "Electronic"
}
]
}
],
"documents": [
{
"passengerIds": [
"pas_0000B7avhgfVejj9UCTZhq"
],
"type": "electronic_ticket",
"id": "1"
}
],
"bookingReferences": [
{
"reference": "YIYLIU",
"airline": {
"name": "Duffel Airways",
"iataCode": "ZZ",
"logoURL": "https://assets.duffel.com/img/airlines/for-light-background/full-color-logo/ZZ.svg",
"conditionsOfCarriage": "https://duffelairways.com/dummy-url/conditions-of-carriage"
}
}
],
"totalAmount": 221.89,
"offerId": "off_0000B7avhgxqQpXBVp2r7H"
},
"liveMode": false
}