Historical Flight Routes & Airports Database
A read-only HTTP API over a consolidated **historical** flights-reference dataset combining two authoritative sources. This is an archive and metadata API — not a live flight status or booking service. It combines two authoritative sources: - **[OpenFlights](https://openflights.org/data.html)** — the open airport/route registry used across the aviation-data community. Provides ~7,700 airports…
Historical Flight Routes & Airports Database endpoints
| Method | Endpoint | Description |
|---|---|---|
| meta | ||
| GET |
getHealth /health |
Returns 200 with `{"status":"ok"}`. No authentication required. |
| airports | ||
| GET |
listAirports /v1/airports |
|
| GET |
airportsNearest /v1/airports/nearest |
Pro-tier or higher. Unbounded-radius variant of `/v1/airports/near` — returns the `limit` closest airports to (`lat`, `lng`), ordered by distance. |
| GET |
getAirport /v1/airports/{iata} |
|
| GET |
airportsNear /v1/airports/near |
Pro-tier or higher. Returns airports within `radius_km` kilometres of (`lat`, `lng`), ordered by distance ascending. Pro callers are capped at 500 km; Ultra+ is effectively… |
| POST |
bulkAirports /v1/airports/bulk |
Pro-tier or higher. Returns airports matching any code in the request body. Missing codes are silently dropped — callers can diff the input vs `iata_code` values in the response… |
| GET |
getAirportDestinations /v1/airports/{iata}/destinations |
|
| GET |
getAirportAirlines /v1/airports/{iata}/airlines |
|
| routes | ||
| GET |
connections /v1/connections/{origin}/{dest} |
Ultra-tier. Returns intermediate airports reachable from `origin` such that there's also a historical route from that airport to `dest`. Options ranked by combined leg-1 + leg-2… |
| POST |
bulkRoutes /v1/routes/bulk |
Pro-tier or higher. Each token is `ORIGIN-DEST` using IATA codes, e.g. `JFK-LAX`. The returned `RouteDetail` objects have empty `airlines`/`top_aircraft` arrays — call… |
| GET |
routeYearly /v1/routes/{origin}/{dest}/yearly |
Pro-tier. Returns per-year leg counts between `origin` and `dest` (IATA codes). Optional `season=summer|winter|all` filter matches the FlightDB schedule flag. Pro is capped at a… |
| GET |
getRoute /v1/routes/{origin}/{dest} |
|
| airlines | ||
| POST |
bulkAirlines /v1/airlines/bulk |
Pro-tier or higher. Codes match either internal `code` or `iata_code`. Caps: Pro 100, Ultra+ 500. |
| GET |
getAirline /v1/airlines/{code} |
|
| GET |
airlineTopRoutes /v1/airlines/{code}/top-routes |
Pro-tier. Returns the top `limit` routes by leg count for the airline (matched on either internal code or IATA code). |
| GET |
airlineFleet /v1/airlines/{code}/fleet |
Ultra-tier. Aggregates `legs` by `aircraft_code` for the airline. |
| GET |
listAirlines /v1/airlines |
|
| exports | ||
| GET |
exportLegsCsv /v1/exports/legs.csv |
Ultra-tier. Streams a CSV of legs matching the given filters. All filters are optional; omitting them exports the full 3.67 M-row table up to the 100 k hard cap per request. Use… |
| markets | ||
| GET |
marketShare /v1/markets/share |
Ultra-tier. Returns airline share of legs originating in `country` during `year`. Country matches `airports.country` (full name, not ISO2 — e.g. "United States"). |
| aircraft | ||
| GET |
listAircraft /v1/aircraft |
|
| GET |
getAircraft /v1/aircraft/{code} |
|
| search | ||
| GET |
search /v1/search |
Trigram (`pg_trgm`) similarity search. Results are ranked by similarity score descending. Maximum 50 results per entity. **Tier gating** — `type=airport` (default) is free-tier.… |
| Other endpoints | ||
| GET |
listAirlines /v1/airlines |
|
| GET |
getAirline /v1/airlines/{code} |
|
| GET |
getAirportDestinations /v1/airports/{iata}/destinations |
|
| GET |
getRoute /v1/routes/{origin}/{dest} |
|
| GET |
getAirport /v1/airports/{iata} |
|
| GET |
listAirports /v1/airports |
|
| GET |
getAirportAirlines /v1/airports/{iata}/airlines |
|
| GET |
getHealth /health |
Returns 200 with `{"status":"ok"}`. No authentication required. |
| GET |
getAircraft /v1/aircraft/{code} |
|
| GET |
searchAirports /v1/search |
Uses PostgreSQL `pg_trgm` trigram similarity. Results are ranked by similarity score descending. Maximum 50 results. |
Historical Flight Routes & Airports Database pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $14.99 / month | 10 / second |
|
| ULTRA | $49.99 / month | 30 / second |
|