GET/v1/transfers/flights

Search transfer flights

Look up the flight a traveller is arriving on or departing with.

Share
GET/v1/transfers/flights

API console

Try it

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

Credentials

Log in to pick from your saved API keys instead of pasting them.

Query parameters

7 fields

Airline code

Two-character IATA airline code, such as W6.

Airport code

Three-character IATA airport code, such as BCN.

Flight direction

Whether the traveller is arriving at or departing from the airport.

Pickup date and time

Local pickup date and time, for example 2026-06-30 10:45.

Flight number

Flight number without the airline code.

Currency

Currency of the returned amounts. Must match the offer or reservation when one already exists.

Language

Legacy language field. Prefer the LANG or Accept-Language header.

cURL request

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'

Add your credentials to send a request.

Response

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

Look up the flight a traveller is arriving on or departing with.

Authentication and headers

HeaderDescription
AuthorizationBearer <secret_key>. Keep the secret on the server and never write it to client logs.
X-Travelandz-Id<public_key>:<profile_code>, where the persisted profile code has the form dp_<12 alphanumeric>.
LANGPreferred locale header. Accept-Language is also supported.
Content-Typeapplication/json for requests with a JSON body.

Request

This endpoint takes no body. All five identifying query parameters are required.

Request Query Params Schema

airlineCode
string
Format: IATA (2 characters)
Yes
airportCode
string
Format: IATA (3 characters)
Yes
flightDirection
enum
arrivingdepartingarrdep
Yes
pickupDatetime
stringYes
flightNumber
stringYes
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.

Success response

Returns flights[]. An empty array is a successful result and simply means no flight matched.

Response Body Schema

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

Response examples

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

Errors

HTTPCodeMeaningRecommended action
400The body, query or path is invalid, or contains an unknown property.Fix the request using the message array.
400transfer_invalid_currencyThe currency is outside the supported list.Use a supported currency.
400transfer_invalid_languageThe requested language is not supported.Use one of the documented language values.
429transfer_provider_errorThe service is temporarily rate limited.Retry with exponential backoff.
502transfer_provider_errorThe request could not be completed.Do not assume success. Keep your identifiers and read the reservation when the operation could have been created.

Usage notes

Use this endpoint to fill airline and flightNumber for booking, then verify the flight against the pickup time before you charge the traveller.

cURL example

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"