# Airports Reference

Airport lookup, nearest airports, distances, runways and hubs from OurAirports open data.

## 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://airports-reference.x402tookit.com/openapi.json
- x402 manifest: https://airports-reference.x402tookit.com/.well-known/x402
- Catalog (free): https://airports-reference.x402tookit.com/catalog
- Health (free): https://airports-reference.x402tookit.com/health
- Uptime (free): https://airports-reference.x402tookit.com/uptime

## Endpoints (8)

### GET /airport-code-convert — $0.02
Convert an airport code between IATA (3 letters) and ICAO (4 letters) and validate the format; reports unknown codes.
Params: code: string
Example: https://airports-reference.x402tookit.com/airport-code-convert?code=EGLL

### GET /airport-distance — $0.02
Great-circle distance in km, miles and nautical miles between two airports, with a rough flight time estimate.
Params: from: string, to: string, speedKmh?: integer
Example: https://airports-reference.x402tookit.com/airport-distance?from=JFK&to=LHR

### GET /airport-lookup — $0.02
Find an airport by IATA code, ICAO code or name with fuzzy matching: location, elevation, type, longest runway.
Params: q: string, country?: string
Example: https://airports-reference.x402tookit.com/airport-lookup?q=Heathrow

### GET /airport-runways — $0.02
Runway facts for an airport by IATA, ICAO or name: longest runway, surface, lighting, headings, closed runways.
Params: q: string
Example: https://airports-reference.x402tookit.com/airport-runways?q=DEN

### GET /airport-timezone — $0.02
Time zone offset of an airport: reports whether the dataset has one (it does not) and gives a nominal solar offset.
Params: q: string
Example: https://airports-reference.x402tookit.com/airport-timezone?q=SYD

### GET /airports-in — $0.02
List airports in a country or ISO region (like US-CO) filtered by size and scheduled service, with codes.
Params: country: string, region?: string, type?: string, scheduled?: string, limit?: integer
Example: https://airports-reference.x402tookit.com/airports-in?country=NZ&type=medium&limit=10

### GET /airports-near — $0.02
Nearest airports to a latitude and longitude with distance, bearing, type and codes; filter by size or scheduled service.
Params: lat: number, lon: number, radiusKm?: integer, limit?: integer, type?: string, scheduled?: string
Example: https://airports-reference.x402tookit.com/airports-near?lat=40.7128&lon=-74.006&radiusKm=100&limit=5&type=large

### GET /big-hubs — $0.02
Busiest large airports ranked by annual passengers (latest Wikidata figure), optionally by country or continent.
Params: country?: string, continent?: string, limit?: integer
Example: https://airports-reference.x402tookit.com/big-hubs?continent=EU&limit=5

## Terms

Reference data from OurAirports (public domain, crowd-edited, no guarantee of accuracy) cross-checked against Wikidata, provided as is. Codes, runways and coordinates change and errors exist; flight times are rough estimates from great-circle distance and an assumed cruise speed, not schedules. Not for navigation, flight planning, dispatch or safety decisions; consult official aeronautical publications.