GET/v1/transfers/flights

Buscar vuelos para transfers

Busca el vuelo en el que el viajero llega o con el que sale.

Compartir
GET/v1/transfers/flights

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 consulta

7 campos

Código de aerolínea

Código IATA de aerolínea de dos caracteres, por ejemplo W6.

Código de aeropuerto

Código IATA de aeropuerto de tres caracteres, por ejemplo BCN.

Dirección del vuelo

Si el viajero llega al aeropuerto o sale de él.

Fecha y hora de pickup

Fecha y hora local de pickup, por ejemplo 2026-06-30 10:45.

Número de vuelo

Número de vuelo sin el código de aerolínea.

Moneda

Moneda de los importes devueltos. Debe coincidir con la oferta o la reserva cuando ya existe una.

Idioma

Campo de idioma legacy. Es preferible usar el header LANG o Accept-Language.

Petición cURL

cURL
bash
curl -X GET 'https://api.sandbox.travelandz.com/v1/transfers/flights?airlineCode=W6&airportCode=BCN&flightDirection=arriving&pickupDatetime=2026-06-30+10%3A45&flightNumber=1705&currency=USD' \
  -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í.

Busca el vuelo en el que el viajero llega o con el que sale.

Autenticación y headers

HeaderDescripción
AuthorizationBearer <secret_key>. Conserva el secret en el servidor y nunca lo escribas en logs del cliente.
X-Travelandz-Id<public_key>:<profile_code>, donde el profile code persistido usa el formato dp_<12 alfanuméricos>.
LANGHeader recomendado para el idioma. También se acepta Accept-Language.
Content-Typeapplication/json para peticiones con body JSON.

Petición

Este endpoint no recibe body. Los cinco parámetros de query identificadores son obligatorios.

Schema de query params

airlineCode
string
Formato: IATA (2 characters)
Sí
airportCode
string
Formato: IATA (3 characters)
Sí
flightDirection
enum
arrivingdepartingarrdep
Sí
pickupDatetime
stringSí
flightNumber
stringSí
currency
enum
EURUSDINRCHFJPYGBPAUDCADCNYSGDNZDMXN
No
Lowercase values are accepted and normalized. Defaults to USD on a new search and is inherited afterwards.
language
enum
en-USes-ESde-DEfr-FRpt-BRzh-CNit-IT
No
Legacy field. Prefer the LANG or Accept-Language header.

Respuesta exitosa

Devuelve flights[]. Un array vacío es un resultado exitoso y solo significa que ningún vuelo coincidió.

Schema de respuesta

flights
arraySí
flights[]airlineCode
stringSí
flights[]airlineName
stringNo
flights[]flightNumber
stringSí
flights[]flightCode
stringNo
Airline code and flight number combined.
flights[]flightType
enum
domesticinternational
No
flights[]origin
string
Formato: IATA (3 characters)
No
flights[]destination
string
Formato: IATA (3 characters)
No
flights[]time
stringNo
Localized display time.
flights[]datetime
string
Formato: ISO 8601
No

Ejemplos de respuesta

json
json
{
  "flights": [
    {
      "airlineCode": "W6",
      "airlineName": "Wizz Air",
      "flightNumber": "1705",
      "flightCode": "W61705",
      "flightType": "international",
      "origin": "GDN",
      "destination": "BCN",
      "time": "9:10PM",
      "datetime": "2026-06-30T21:10:00+02:00"
    }
  ]
}

Errores

HTTPCódigoSignificadoAcción recomendada
400El body, la query o el path son inválidos, o incluyen una propiedad desconocida.Corrige la petición usando el array message.
400transfer_invalid_currencyLa moneda está fuera de la lista soportada.Usa una moneda soportada.
400transfer_invalid_languageEl idioma solicitado no está soportado.Usa uno de los valores de idioma documentados.
429transfer_provider_errorEl servicio está temporalmente limitado por rate limit.Reintenta con backoff exponencial.
502transfer_provider_errorLa petición no pudo completarse.No asumas que tuvo éxito. Conserva tus identificadores y consulta la reserva cuando la operación pudiera haberse creado.

Notas de uso

Usa este endpoint para rellenar airline y flightNumber al reservar, y después verifica el vuelo contra la hora de pickup antes de cobrar al viajero.

Ejemplo cURL

bash
bash
curl --request GET \
  --url "https://api.sandbox.travelandz.com/v1/transfers/flights?airlineCode=W6&airportCode=BCN&flightDirection=arriving&pickupDatetime=2026-06-30%2010%3A45&flightNumber=1705&currency=USD" \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE"