# Airlines Reference – Airline Name Search

> Airlines Reference – Airline Name Search 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).

Search for airlines by a name fragment (minimum 2 characters), returning up to 50 matches with IATA/ICAO codes, country, callsign, and active status.

## Facts

- Endpoint: GET https://airlines-reference.x402tookit.com/airline-search?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-name-search-caddc4e9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_75jdrBF2XG1jzQkSyltMu

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-name-search-caddc4e9
```

Example prompt: Search for airlines with 'united' in their name and show me only the active ones — I need their IATA and ICAO codes.

## When to prefer this

Use this endpoint when you need to search for airlines by a partial name string and want back structured IATA/ICAO codes, country, callsign, and active status. Prefer this over the exact-code lookup endpoint when the user knows only part of an airline's name. It is particularly useful for autocomplete, disambiguation between similarly named carriers, or filtering by active status when the full airline identifier is unknown.

## Known failure modes

- Query fragment shorter than 2 characters returns an error or empty result
- No airlines match the fragment — empty results array returned
- Invalid 'active' filter value may be ignored or cause an error
- Limit parameter outside 1–50 range may be clamped or rejected
- Data reflects a 2017 OpenFlights snapshot so recently formed or defunct airlines may be missing or stale

## How this service works

Search airlines by name fragment (min 2 chars), active first, optional active filter, capped at 50 results.

## Output

Returns a list of up to 50 airline records matching the name fragment, each including airline name, IATA code, ICAO code, radio callsign, country, active/inactive flag, OpenFlights ID, and route count from the snapshot. Also includes metadata such as query echo, total match count, data source, snapshot date, attribution, and any disclaimer.

## 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": "Name fragment, e.g. 'united' or 'air nz'"
      },
      "limit": {
       "type": "integer",
       "description": "Results 1 to 50 (default 20)"
      },
      "active": {
       "type": "string",
       "description": "Y for active only, N for inactive only, any (default)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "query": {
       "type": [
        "null",
        "string"
       ]
      },
      "total": {
       "type": [
        "null",
        "number"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "results": {
       "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": [
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/airlines-reference-airline-name-search-caddc4e9/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)