POST/v1/flights/offers/:gdsprovider
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
1 campoProveedor GDS
Sistema de distribución global usado para obtener contenido de vuelos. Selecciona 0 para el proveedor predeterminado.
Cuerpo de la petición
Petición cURL
bash
curl -X POST 'https://api.sandbox.travelandz.com/v1/flights/offers/0' \
-H 'Authorization: Bearer YOUR_SECRET_KEY' \
-H 'X-Travelandz-Id: YOUR_PUBLIC_KEY:YOUR_PROFILE_CODE' \
-H 'Content-Type: application/json' \
-d '{"slices":[{"origin":"MAD","destination":"BCN","departure_date":"2026-08-20"}],"passengers":[{"type":"adult"}],"cabin_class":"economy","currency":"EUR","language":"es"}'Añade tus credenciales para enviar una petición.
Respuesta
Pulsa «¡Pruébalo!» para enviar una petición y ver la respuesta aquí.
Busca ofertas de vuelo en una fuente especifica cuando una integracion debe apuntar explicitamente a un solo gdsprovider.
Endpoint
| Método | Ruta | Auth |
|---|---|---|
POST | /v1/flights/offers/:gdsprovider | 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
gdsproviderValores aceptados:
0, 1Esquema del cuerpo de la petición
slicesslices[]originCodigo IATA del aeropuerto o ciudad de origen
slices[]destinationCodigo IATA del aeropuerto o ciudad de destino
slices[]departure_dateNo debe estar en el pasado
passengerspassengers[]typecabin_classcurrencyPor defecto EUR
languageIdioma opcional para metadata traducida cuando este disponible
Respuesta exitosa
Devuelve offers[] del proveedor seleccionado.
Esquema del cuerpo de la respuesta
offersoffers[]offerIdoffers[]gdsprovideroffers[]expiresAtoffers[]totalAmountoffers[]holdOptionsoffers[]holdOptionsavailableoffers[]holdOptionspaymentRequiredByoffers[]holdOptionspriceGuarantedUntiloffers[]supportedPassengerIdDocumentsoffers[]supportedPassengerIdDocuments[]offers[]passengerIdentityDocumentsRequiredoffers[]supportedLoyaltyProgramsoffers[]supportedLoyaltyPrograms[]offers[]airlineoffers[]airlinenameoffers[]airlineiataCodeoffers[]airlinelogoURLoffers[]airlineconditionsOfCarriageoffers[]passengersoffers[]passengers[]idPublic passenger id to reuse during booking. Mystifly public offers generate internal ids such as
mystifly_pax_1.offers[]passengers[]typeoffers[]conditionsoffers[]conditionsrefundBeforeDepartureoffers[]conditionsrefundBeforeDeparturecurrencyoffers[]conditionsrefundBeforeDeparturepenaltyAmountoffers[]conditionsrefundBeforeDepartureallowedoffers[]conditionschangeBeforeDepartureoffers[]conditionschangeBeforeDeparturecurrencyoffers[]conditionschangeBeforeDeparturepenaltyAmountoffers[]conditionschangeBeforeDepartureallowedoffers[]slicesoffers[]slices[]fareNameoffers[]slices[]departureoffers[]slices[]departureiataCodeoffers[]slices[]departurecityNameoffers[]slices[]departureairportNameoffers[]slices[]departuredepartingAtoffers[]slices[]departuretimeZoneoffers[]slices[]arrivaloffers[]slices[]arrivaliataCodeoffers[]slices[]arrivalcityNameoffers[]slices[]arrivalairportNameoffers[]slices[]arrivalarrivingAtoffers[]slices[]arrivaltimeZoneoffers[]slices[]durationMinutesoffers[]slices[]conditionsoffers[]slices[]conditionspriorityCheckInoffers[]slices[]conditionspriorityBoardingoffers[]slices[]conditionsadvanceSeatSelectionoffers[]slices[]segmentsoffers[]slices[]segments[]fareNameoffers[]slices[]segments[]departureoffers[]slices[]segments[]departureiataCodeoffers[]slices[]segments[]departurecityNameoffers[]slices[]segments[]departureairportNameoffers[]slices[]segments[]departuredepartingAtoffers[]slices[]segments[]departuretimeZoneoffers[]slices[]segments[]departureterminaloffers[]slices[]segments[]arrivaloffers[]slices[]segments[]arrivaliataCodeoffers[]slices[]segments[]arrivalcityNameoffers[]slices[]segments[]arrivalairportNameoffers[]slices[]segments[]arrivalarrivingAtoffers[]slices[]segments[]arrivaltimeZoneoffers[]slices[]segments[]arrivalterminaloffers[]slices[]segments[]airlineoffers[]slices[]segments[]airlineoperatingCarrieroffers[]slices[]segments[]airlineoperatingCarriernameoffers[]slices[]segments[]airlineoperatingCarrieriataCodeoffers[]slices[]segments[]airlineoperatingCarrierlogoURLoffers[]slices[]segments[]airlineoperatingCarrierconditionsOfCarriageoffers[]slices[]segments[]airlinemarketingCarrieroffers[]slices[]segments[]airlinemarketingCarriernameoffers[]slices[]segments[]airlinemarketingCarrieriataCodeoffers[]slices[]segments[]airlinemarketingCarrierlogoURLoffers[]slices[]segments[]airlinemarketingCarrierconditionsOfCarriageoffers[]slices[]segments[]flightNumberoffers[]slices[]segments[]durationMinutesoffers[]slices[]segments[]passengersoffers[]slices[]segments[]passengers[]amenitiesoffers[]slices[]segments[]passengers[]amenitieswifioffers[]slices[]segments[]passengers[]amenitieswificostoffers[]slices[]segments[]passengers[]amenitieswifiavailableoffers[]slices[]segments[]passengers[]amenitiesseatoffers[]slices[]segments[]passengers[]amenitiesseatpitchoffers[]slices[]segments[]passengers[]amenitiesseatlegroomoffers[]slices[]segments[]passengers[]amenitiesseattypeoffers[]slices[]segments[]passengers[]amenitiespoweroffers[]slices[]segments[]passengers[]baggagesoffers[]slices[]segments[]passengers[]baggages[]typeoffers[]slices[]segments[]passengers[]baggages[]quantityoffers[]slices[]segments[]passengers[]baggages[]maxKgoffers[]CO2EmissionsKgoffers[]holdIdoffers[]originalCurrencyoffers[]currencyliveModeTrue cuando la peticion se sirve desde el entorno live de Travelandz. Este valor viene de Travelandz, no del payload del proveedor.
Notas operativas
Usa este endpoint solo cuando la integracion deba forzar un proveedor. La forma de la respuesta coincide con la busqueda publica de vuelos.
Ejemplo
bash
curl -X POST https://api.sandbox.travelandz.com/v1/flights/offers/0 \
-H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
-H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE" \
-H "Content-Type: application/json" \
-d '{"slices":[{"origin":"MAD","destination":"BCN","departure_date":"2026-08-20"}],"passengers":[{"type":"adult"}],"cabin_class":"economy","currency":"EUR"}'