GET/v1/flights/booking/:gdsprovider/:orderId
Consola API
Pruébalo
Envía una petición real al entorno sandbox e inspecciona la respuesta.
Credenciales
Inicia sesión para elegir entre tus API keys guardadas en vez de pegarlas.
Parámetros de ruta
2 camposProveedor GDS
Sistema de distribución global usado para obtener contenido de vuelos. Selecciona 0 para el proveedor predeterminado.
ID de orden
Identificador de la orden devuelta al crear la reserva.
Petición cURL
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'Añade tus credenciales para enviar una petición.
Respuesta
Pulsa «¡Pruébalo!» para enviar una petición y ver la respuesta aquí.
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 |
| Header | Descripción |
|---|---|
Authorization | Bearer <secret_key>. El secret se muestra una sola vez al crear la credencial. |
X-Travelandz-Id | <public_key>:<profile_code>. El profile_code es el codigo de Developer Profile con prefijo dp_ que ves en el dashboard. Esto vincula la peticion con un perfil y una credencial. |
Content-Type | Usa application/json para peticiones con cuerpo. |
Esquema de parámetros de la petición
gdsproviderorderIdCuerpo de la petición
No requiere cuerpo de petición.
Respuesta exitosa
Devuelve detalles de la orden
Esquema del cuerpo de la respuesta
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 cuando la peticion se sirve desde el entorno live de Travelandz. Este valor viene de Travelandz, no del payload del proveedor.
Notas operativas
- El detalle de la respuesta puede variar por fuente.
- Algunas respuestas de reserva pueden devolver pasajeros y tickets sin slices de vuelo. Cuando la orden se creo despues de una busqueda publica, Travelandz enriquece
slices,conditionsyofferIddesde la oferta parseada y trackeada. - Si no existe un snapshot de oferta trackeada, el endpoint devuelve el detalle disponible del proveedor sin fallar solo porque falten slices.
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"Respuestas
| Código | Descripción |
|---|---|
200 | Detalle de reserva de vuelo recuperado correctamente. |
400 | Solicitud inválida: payload no válido. |
401 | No autorizado: credenciales inválidas o ausentes. |
403 | Prohibido: credenciales inválidas. |
500 | Error interno del servidor |
200 Cuerpo de la respuesta
Tipo de contenido: 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
}