Airports

Search, nearby lookup, and airport + runway detail.

The airports resource is the entry point for almost everything else — most other endpoints key off the ICAO code you find here.

GET/v1/airports/search
Fuzzy search by name, municipality, ICAO, or IATA
GET/v1/airports/nearby
Airports within a radius of a lat/lng point
GET/v1/airports
Paginated list, filterable by country and type
GET/v1/airports/{icao_code}
Single airport with its runways
GET/v1/airports/iata/{iata_code}
Same, looked up by IATA code

Search

ParamTypeDescription
q*stringMinimum 2 characters. Matched against name, municipality, ICAO, and IATA code.
limitintDefault 20, max 100.
GET /v1/airports/iata/SFO
{
  "icao_code":: "KSFO",
  "iata_code":: "SFO",
  "name":: "San Francisco International Airport",
  "type":: "large_airport",
  "municipality":: "San Francisco",
  "country":: "US",
  "region":: "US-CA",
  "lat":: 37.6188,
  "lng":: -122.3750,
  "elevation_ft":: 13,
  "timezone":: "America/Los_Angeles",
  "scheduled_service":: true,
  "runways":: [
    {
      "id":: 1,
      "ident":: "28L",
      "length_ft":: 11870,
      "width_ft":: 200,
      "surface":: "ASPH",
      "lighted":: true,
      "closed":: false,
      "bearing_true":: 283.6,
      "reciprocal_runway_id":: 2
    }
  ]
}

Nearby

ParamTypeDescription
lat*float-90 to 90
lng*float-180 to 180
radius_kmfloatDefault 50, max 1000
limitintDefault 20, max 200