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.

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