Aviation Data

Airport — full unified profile

Single-call airport profile fusing OurAirports + ADSB.lol live traffic.

GET/v1/aviation/airports/{id}/fullRequires X-API-Key

Returns the airport master record plus runways, frequencies and navaids (OurAirports) and the live aircraft snapshot within 25 NM (ADSB.lol). FAA Registry cross-join is planned but not yet implemented. Each sub-block is optional — the call succeeds even if a single source is disabled or still syncing. Live aircraft entries carry per-aircraft `provenance` blocks.

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.

Path parameters

idstringRequired

IATA, ICAO or internal id.

Example: MAD

Request

GET

BASH·cURL

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

API Key

Path parameters

id

Enter an API key to enable the request.

Response

JSON·200 response

{
  "data": {
    "airport": {
      "id": "mad",
      "iata_code": "MAD",
      "icao_code": "LEMD",
      "name": "Adolfo Suárez Madrid–Barajas Airport",
      "city": "Madrid",
      "country": "ES",
      "latitude": 40.493407,
      "longitude": -3.572249,
      "elevation_ft": 1998,
      "timezone": "Europe/Madrid",
      "runways_count": 4
    },
    "runways": [
      {
        "length_ft": 11483,
        "width_ft": 197,
        "surface": "ASP",
        "le_ident": "14L",
        "he_ident": "32R",
        "lighted": true
      }
    ],
    "frequencies": [
      {
        "type": "TWR",
        "description": "TWR 36L",
        "frequency_mhz": 118.07
      }
    ],
    "navaids": [
      {
        "ident": "BRA",
        "name": "Barajas",
        "type": "VOR-DME",
        "frequency_khz": 116450,
        "latitude": 40.469,
        "longitude": -3.5575
      }
    ],
    "live_traffic": {
      "radius_nm": 25,
      "as_of": "2026-05-30T12:08:56Z",
      "aircraft": [
        {
          "icao24": "3485d2",
          "callsign": "ANE25WM",
          "latitude": 40.356,
          "longitude": -3.868,
          "baro_altitude": 13225,
          "velocity": 304.9,
          "heading": 140.72,
          "vertical_rate": -1760,
          "on_ground": false,
          "last_contact": "2026-05-30T12:08:56Z",
          "provenance": {
            "source": "adsblol",
            "source_type": "derived-from-adsb",
            "license": "ODbL 1.0 (ADSB.lol)",
            "confidence": "medium"
          }
        }
      ]
    }
  },
  "meta": {
    "request_id": "01HVN9M5K..."
  },
  "errors": []
}