# Airlines Reference – Airline Lookup by IATA, ICAO, or Name

> Airlines Reference – Airline Lookup by IATA, ICAO, or Name is a paid API for AI agents from airlines-reference.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

Look up an airline by its IATA code (e.g. BA), ICAO code (e.g. BAW), or full name, returning callsign, country, active status, and route count from a 2017 OpenFlights snapshot.

## Facts

- Endpoint: GET https://airlines-reference.x402tookit.com/airline-lookup?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/airlines-reference-airline-lookup-by-iata-icao-or-name-ad9985c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iHGGm86lBR1_11Q8RTLv-

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability airlines-reference-airline-lookup-by-iata-icao-or-name-ad9985c3
```

Example prompt: Look up the airline with IATA code BA and tell me its full name, ICAO code, callsign, country, and whether it's still active.

## When to prefer this

Use this endpoint when you need to resolve an IATA or ICAO airline code to its full details (name, country, callsign, active status) or vice versa, especially for reference enrichment in aviation workflows. It covers both active and defunct airlines from the OpenFlights 2017 snapshot, making it suitable for historical lookups. Prefer this over general web search when you need structured, machine-readable airline metadata with consistent field coverage.

## Known failure modes

- No matches found for an obscure or misspelled airline code or name
- Airline exists but was added after 2017 and is absent from the snapshot
- Ambiguous name query returns multiple matches requiring disambiguation
- Empty or missing query parameter returns a validation error
- Defunct airline data may be incomplete or have null fields

## How this service works

Find an airline by IATA (BA), ICAO (BAW) or name: callsign, country, active flag. 2017 snapshot incl. defunct airlines.

## Output

Returns a list of matching airlines, each with IATA code, ICAO code, airline name, alias, radio callsign, country of registration, active status (boolean), OpenFlights ID, and number of routes in the 2017 snapshot. Also includes metadata such as total match count, what field was matched on, a summary, and a disclaimer about the data being a 2017 snapshot.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "IATA code (BA), ICAO code (BAW) or airline name (British Airways)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "input": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "matches": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "iata": {
          "type": [
           "null",
           "string"
          ]
         },
         "icao": {
          "type": [
           "null",
           "string"
          ]
         },
         "name": {
          "type": [
           "null",
           "string"
          ]
         },
         "alias": {},
         "active": {
          "type": [
           "boolean",
           "null"
          ]
         },
         "country": {
          "type": [
           "null",
           "string"
          ]
         },
         "callsign": {
          "type": [
           "null",
           "string"
          ]
         },
         "openflightsId": {
          "type": [
           "null",
           "number"
          ]
         },
         "routesInSnapshot": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "ty
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/airlines-reference-airline-lookup-by-iata-icao-or-name-ad9985c3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from airlines-reference.x402tookit.com](https://www.zero.xyz/host/airlines-reference.x402tookit.com/llms.txt)