POST/v1/flights/loyalty-programmes

Search loyalty programmes

Searches airline loyalty programmes by name for incremental search and passenger form autocomplete.

POST/v1/flights/loyalty-programmes

API console

Try it

Send a real request to the sandbox API and inspect the response.

Credentials

Profile code

Public key

Secret key

Request body

{
  "name": "Iberia"
}

cURL request

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"}'

Add your credentials to send a request.

Response

Click "Try it!" to send a request and see the response here.

Searches airline loyalty programmes by name for incremental search and passenger form autocomplete.

Endpoint

Method	Path	Auth
`POST`	`/v1/flights/loyalty-programmes`	Required API key

Required headers:

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 Parameters

No path or query params are required.

Request Body Schema

name

stringYes

Success Response

Returns matching loyalty programmes.

Response Body Schema

loyaltyProgrammes

arrayYes

loyaltyProgrammes[]loyalty

objectYes

loyaltyProgrammes[]loyaltyid

stringYes

loyaltyProgrammes[]loyaltyname

stringNo

loyaltyProgrammes[]loyaltyowner_airline_id

stringNullable

loyaltyProgrammes[]loyaltyalliance

stringNullable

loyaltyProgrammes[]loyaltylogo_url

stringNullable

loyaltyProgrammes[]airline

objectYes

loyaltyProgrammes[]airlineid

stringYes

loyaltyProgrammes[]airlinename

stringYes

loyaltyProgrammes[]airlineiata_code

stringNullable

loyaltyProgrammes[]airlinelogo_symbol_url

stringNullable

loyaltyProgrammes[]airlinelogo_lockup_url

stringNullable

loyaltyProgrammes[]airlineconditions_of_carriage_url

stringNullable

liveMode

booleanYes

True when the request is served by the live Travelandz environment. This value comes from Travelandz, not the provider payload.

Operational Notes

The search term can match a loyalty programme name or airline name when provider metadata can resolve it.

Example

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"}'

Request Body - Example Value

json

{
  "name": "Iberia"
}

Responses

Code	Description
`200`	Matching loyalty programmes 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

{
  "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
}