POST/v1/flights/loyalty-programmes

Buscar programas de fidelidad

Busca programas de fidelidad por nombre para autocompletados y formularios incrementales de pasajeros.

POST/v1/flights/loyalty-programmes

Consola API

Pruébalo

Envía una petición real al entorno sandbox e inspecciona la respuesta.

Credenciales

Profile code

Public key

Secret key

Inicia sesión para elegir entre tus API keys guardadas en vez de pegarlas.

Cuerpo de la petición

{
  "name": "Iberia"
}

Petición cURL

cURL

bash

curl -X POST 'https://api.sandbox.travelandz.com/v1/flights/loyalty-programmes' \
  -H 'Authorization: Bearer YOUR_SECRET_KEY' \
  -H 'X-Travelandz-Id: YOUR_PUBLIC_KEY:YOUR_PROFILE_CODE' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Iberia"}'

Añade tus credenciales para enviar una petición.

Respuesta

Pulsa «¡Pruébalo!» para enviar una petición y ver la respuesta aquí.

Busca programas de fidelidad por nombre para autocompletados y formularios incrementales de pasajeros.

Endpoint

Método	Ruta	Auth
`POST`	`/v1/flights/loyalty-programmes`	API key requerida

Headers obligatorios:

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.

Parámetros de la petición

No requiere parámetros de ruta ni query.

Esquema del cuerpo de la petición

name

stringSí

Respuesta exitosa

Devuelve matching programas de fidelidad.

Esquema del cuerpo de la respuesta

loyaltyProgrammes

arraySí

loyaltyProgrammes[]loyalty

objectSí

loyaltyProgrammes[]loyaltyid

stringSí

loyaltyProgrammes[]loyaltyname

stringNo

loyaltyProgrammes[]loyaltyowner_airline_id

stringNulable

loyaltyProgrammes[]loyaltyalliance

stringNulable

loyaltyProgrammes[]loyaltylogo_url

stringNulable

loyaltyProgrammes[]airline

objectSí

loyaltyProgrammes[]airlineid

stringSí

loyaltyProgrammes[]airlinename

stringSí

loyaltyProgrammes[]airlineiata_code

stringNulable

loyaltyProgrammes[]airlinelogo_symbol_url

stringNulable

loyaltyProgrammes[]airlinelogo_lockup_url

stringNulable

loyaltyProgrammes[]airlineconditions_of_carriage_url

stringNulable

liveMode

booleanSí

True cuando la peticion se sirve desde el entorno live de Travelandz. Este valor viene de Travelandz, no del payload del proveedor.

Notas operativas

El termino de busqueda puede coincidir con el nombre del programa de fidelidad o de la aerolinea cuando la metadata del proveedor puede resolverlo.

Ejemplo

bash

curl -X POST https://api.sandbox.travelandz.com/v1/flights/loyalty-programmes \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE" \
  -H "Content-Type: application/json" \
  -d '{"name":"Iberia"}'

Cuerpo de la petición - Ejemplo

json

{
  "name": "Iberia"
}

Respuestas

Código	Descripción
`200`	Programas de fidelidad coincidentes recuperados 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

{
  "loyaltyProgrammes": [
    {
      "loyalty": {
        "owner_airline_id": "arl_00009VME7DCOaPRQvNhcMu",
        "alliance": "oneworld",
        "logo_url": null,
        "name": "Iberia Plus",
        "id": "loy_0000AdwMH7BMi91w0auv2q"
      },
      "airline": {
        "logo_symbol_url": "https://assets.duffel.com/img/airlines/for-light-background/full-color-logo/IB.svg",
        "logo_lockup_url": "https://assets.duffel.com/img/airlines/for-light-background/full-color-lockup/IB.svg",
        "conditions_of_carriage_url": "https://www.iberia.com/gb/bills/conditions/",
        "iata_code": "IB",
        "name": "Iberia",
        "id": "arl_00009VME7DCOaPRQvNhcMu"
      }
    }
  ],
  "liveMode": false
}