# Airlines Reference

Airline lookup by IATA or ICAO code, callsign, country and flight number parsing from the OpenFlights snapshot.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://airlines-reference.x402tookit.com/openapi.json
- x402 manifest: https://airlines-reference.x402tookit.com/.well-known/x402
- Catalog (free): https://airlines-reference.x402tookit.com/catalog
- Health (free): https://airlines-reference.x402tookit.com/health
- Uptime (free): https://airlines-reference.x402tookit.com/uptime

## Endpoints (7)

### GET /airline-callsign — $0.02
Convert an airline radio callsign (SPEEDBIRD) to its airline, or an airline code or name to its callsign.
Params: callsign?: string, airline?: string
Example: https://airlines-reference.x402tookit.com/airline-callsign?callsign=SPEEDBIRD

### GET /airline-lookup — $0.02
Find an airline by IATA (BA), ICAO (BAW) or name: callsign, country, active flag. 2017 snapshot incl. defunct airlines.
Params: q: string
Example: https://airlines-reference.x402tookit.com/airline-lookup?q=BA

### GET /airline-route-between — $0.02
Airlines listed on a route between two airport codes (JFK, LHR) in the old OpenFlights routes snapshot, both directions.
Params: from: string, to: string
Example: https://airlines-reference.x402tookit.com/airline-route-between?from=JFK&to=LHR

### GET /airline-routes — $0.02
Route count and top origin and destination airports for an airline from the old OpenFlights routes snapshot (2017).
Params: airline: string, openflightsId?: integer
Example: https://airlines-reference.x402tookit.com/airline-routes?airline=BA

### GET /airline-search — $0.02
Search airlines by name fragment (min 2 chars), active first, optional active filter, capped at 50 results.
Params: q: string, active?: string, limit?: integer
Example: https://airlines-reference.x402tookit.com/airline-search?q=united&active=Y&limit=5

### GET /airlines-by-country — $0.02
List airlines of a country (name as OpenFlights spells it) with active filter and paging; 'list' gives country counts.
Params: country: string, active?: string, limit?: integer, offset?: integer
Example: https://airlines-reference.x402tookit.com/airlines-by-country?country=Japan&active=Y&limit=10

### GET /flight-number-parse — $0.02
Parse a flight number like BA117, BAW117 or U21234 into airline code, number and suffix, validate format, find the airline.
Params: flight: string
Example: https://airlines-reference.x402tookit.com/flight-number-parse?flight=BAW117

## Terms

Airline data is a static 2017 snapshot of the OpenFlights database (ODbL 1.0), provided as is. It includes defunct and historical airlines (active=N), codes are reused over time, and route data is old and incomplete. Not for operations, ticketing, dispatch or safety decisions; check the airline or IATA/ICAO directly.