NorbaNorba.io
DashboardGet API Key
Aviation Data

List airports

Complete airport catalogue — search by code, country, name, or geographic radius.

GET/v1/aviation/airportsRequires X-API-Key
The definitive airport reference for your application. Returns a filterable, paginated list of airports sourced from OurAirports (Public Domain) and enriched by Norba's internal data layer.Filter by:
- iata — Two-letter IATA code for precise lookups
- icao — Four-letter ICAO code
- country — ISO 3166-1 alpha-2 country code (e.g. ES, GB, US)
- type — Airport classification: large_airport, medium_airport, small_airport, heliport, seaplane_base, closed
- name — Case-insensitive name substring for search-as-you-type
- lat + lon + radius_km — Geographic radius filter (great-circle distance)Geographic filtering lets you find all airports within a distance of a point — perfect for "airports near me" features.Every record includes: coordinates, elevation, timezone, runway count, and full provenance metadata showing the data source. Use this to power airport pickers, route finders, and location-based features.

Request example

curl --request GET \
  --url https://api.norba.io/v1/aviation/airports \
  --header "X-API-Key: $NORBA_KEY"

Response example

Response example
{
  "data": [
    {
      "id": "mad",
      "name": "Adolfo Suárez Madrid–Barajas Airport",
      "iata_code": "MAD",
      "icao_code": "LEMD",
      "city": "Madrid",
      "country": "ES",
      "region": "ES-MD",
      "latitude": 40.493407,
      "longitude": -3.572249,
      "elevation_ft": 1998,
      "airport_type": "large_airport",
      "scheduled_service": true,
      "runways_count": 4
    }
  ],
  "meta": {
    "request_id": "810e8129288eda32",
    "page": 1,
    "limit": 50,
    "count": 1,
    "total": 575,
    "last_updated": "2026-05-30T11:30:29Z"
  },
  "errors": []
}

Authorization

X-API-KeystringRequired
Opaque API key issued from the Norba dashboard. Sent on every request as the X-API-Key HTTP header. Missing or invalid keys are rejected with 401 Unauthorized.

Query parameters

iatastring
Two-letter IATA code for exact match (e.g. MAD, LHR).
icaostring
Four-letter ICAO code for exact match (e.g. LEMD, EGLL).
countrystring
ISO 3166-1 alpha-2 country code. Returns all airports in that country.
Example: ES
typestring
Airport classification: large_airport, medium_airport, small_airport, heliport, seaplane_base, closed.
namestring
Case-insensitive substring search. Perfect for typeahead/autocomplete UIs.
latnumber
Latitude for geographic radius search. Requires lon and radius_km.
lonnumber
Longitude for geographic radius search.
radius_kmnumber
Great-circle radius in kilometres. Finds all airports within this distance of lat,lon.
pageinteger
1-based page number. Default: 1.
Example: 1
limitinteger
Results per page. Max 500. Default: 50.
Example: 50
List airports · Norba API