IATA Flight Number

GET/v0/iata/flight

Validates an IATA flight number in the standard format: a 2-character airline designator (letters or digits) followed by 1–4 digits and an optional single-letter operational suffix (e.g. LO123, AA100A, 6E2045). When the airline designator is recognised, the response includes the airline name, country, ICAO code, and radio callsign.

Try it

Query Parameters

Parameter	Type	Required	Description
value	string	Yes	IATA flight number (e.g. `LO123`, `BA436`, `6E2045`). Input is case-insensitive and whitespace is ignored.

Example Request

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

Response Fields

Field	Type	Description
valid	boolean	Whether the value matches the IATA flight number format
airlineCode	string	2-character IATA airline designator
flightNumber	number	Numeric flight number (1–9999)
suffix	string \| null	Single-letter operational suffix if present, otherwise `null`
airlineName	string \| null	Airline name if the designator is in the directory, otherwise `null`
countryCode	string \| null	ISO 3166-1 alpha-2 country of the airline
countryName	string \| null	Full English name of the airline's country
callsign	string \| null	ICAO radio telephony callsign of the airline
icao	string \| null	3-letter ICAO airline designator

Example Response — known airline

{
  "valid": true,
  "airlineCode": "LO",
  "flightNumber": 123,
  "suffix": null,
  "airlineName": "LOT Polish Airlines",
  "countryCode": "PL",
  "countryName": "Poland",
  "callsign": "POLLOT",
  "icao": "LOT"
}

Example Response — with suffix, unknown airline

{
  "valid": true,
  "airlineCode": "ZZ",
  "flightNumber": 42,
  "suffix": "A",
  "airlineName": null,
  "countryCode": null,
  "countryName": null,
  "callsign": null,
  "icao": null
}

Example Response — invalid format

{ "valid": false }