IATA Airline Code

GET/v0/iata/airline

Validates a 2-character IATA airline designator as assigned by the International Air Transport Association. When recognised, the response includes the airline name, ICAO code, callsign, and country of registration.

Guides: Node.js · Python

Try it

Query Parameters

Parameter	Type	Required	Description
value	string	Yes	2-character IATA airline designator (e.g. `LO`, `BA`, `AA`). Input is case-insensitive.

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/iata/airline?value=LO"

Response Fields

Field	Type	Description
valid	boolean	Whether the value matches the IATA airline designator format (2 alphanumeric characters)
found	boolean	Whether the code is present in the built-in directory. Absent when `valid` is `false`
iata	string	Normalised (uppercase) IATA airline designator
name	string	Full name of the airline
icao	string \| null	3-letter ICAO airline code
callsign	string \| null	Radio telephony callsign used in ATC communications
countryCode	string	ISO 3166-1 alpha-2 country code
countryName	string \| null	Full English name of the country

Example Response

{
  "valid": true,
  "found": true,
  "iata": "LO",
  "name": "LOT Polish Airlines",
  "icao": "LOT",
  "callsign": "POLLOT",
  "countryCode": "PL",
  "countryName": "Poland"
}

Example Response — unknown code

{ "valid": true, "found": false }

Example Response — invalid format

{ "valid": false }

GET/v0/iata/airline/list

Returns the full list of known IATA airline designators with airline details, sorted alphabetically by name.

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/iata/airline/list"

Response Fields

Returns a JSON array. Each element contains:

Field	Type	Description
iata	string	2-character IATA airline designator
name	string	Full name of the airline
icao	string \| null	3-letter ICAO airline code
callsign	string \| null	Radio telephony callsign
countryCode	string	ISO 3166-1 alpha-2 country code
countryName	string \| null	Full English name of the country

Example Response (truncated)

[
  {
    "iata": "A3",
    "name": "Aegean Airlines",
    "icao": "AEE",
    "callsign": "AEGEAN",
    "countryCode": "GR",
    "countryName": "Greece"
  },
  {
    "iata": "AF",
    "name": "Air France",
    "icao": "AFR",
    "callsign": "AIRFRANS",
    "countryCode": "FR",
    "countryName": "France"
  },
  ...
]