airline_lookup
Search airlines by name, IATA/ICAO code, AWB prefix, or country. Returns carrier name, codes, callsign, and verification fields.
Instructions
Search 6,357 airlines by name, IATA code, ICAO code, AWB prefix, or country. AWB prefixes are the first 3 digits of an air waybill number and identify the issuing carrier (e.g. 176 = Emirates).
Provide ONE parameter: query is a ranked fuzzy search across names and codes; iata / icao / prefix / country are exact filters.
Behavior: read-only; fuzzy query hits report their match quality through the envelope's confidence (basis match_quality, score 0-1) with a FUZZY_BEST_MATCH advisory naming the matched field; a query with no hits returns count 0 with a NO_MATCH advisory rather than an error. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header — back off and retry, or call get_subscribe_link for higher limits.
Returns: count and results[] — per airline: airline_name, iata_code, icao_code, awb_prefix[], callsign, country, has_cargo, aliases and per-record verification fields — under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: this dataset's provenance is pending independent verification (the envelope's provenance_status says so) — confirm operationally critical codes with IATA/ICAO or the carrier.
Related: airport_lookup (searches AIRPORTS, not carriers), validate (checks an AWB number's check digit and names its airline from this dataset).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| iata | No | Exact IATA code — 2 alphanumeric characters. Examples: "EK", "U2". | |
| icao | No | Exact ICAO code — 3 letters. Examples: "UAE", "BAW". | |
| query | No | Ranked fuzzy search across name, codes, prefix and country (min 2 chars). Example: "emirates". | |
| prefix | No | Exact AWB prefix — the first 3 digits of an air waybill. Example: "176". | |
| country | No | Filter by country name (min 2 chars). Example: "Netherlands". |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| result | Yes | ||
| _source | Yes | ||
| citation | Yes | ||
| validity | No | ||
| warnings | No | ||
| confidence | Yes | ||
| blocking_errors | No | ||
| envelope_version | Yes | ||
| normalized_input | No |