Aviation Data

Aircraft state by icao24

Most recent live state for one aircraft.

GET/v1/tracking/aircraft/{icao24}Requires X-API-Key

Returns the most recent state vector from ADSB.lol for the given icao24 hex address. Returns `429 rate_limited` in the errors array when throttled.

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

icao24stringRequired

ICAO 24-bit hex address.

Example: 3485d2

Request

GET

BASH·cURL

curl --request GET \
  --url https://api.norba.io/v1/tracking/aircraft/{icao24} \
  --header "X-API-Key: $NORBA_KEY"

API Key

Path parameters

icao24

Enter an API key to enable the request.

Response

JSON·200 response

{
  "data": {
    "icao24": "3485d2",
    "callsign": "ANE25WM",
    "latitude": 40.356414,
    "longitude": -3.86881,
    "baro_altitude": 13225,
    "geo_altitude": 14225,
    "velocity": 304.9,
    "heading": 140.72,
    "vertical_rate": -1760,
    "on_ground": false,
    "last_contact": "2026-05-30T12:08:56Z",
    "squawk": "3437",
    "emergency": "none",
    "provenance": {
      "source": "adsblol",
      "source_type": "derived-from-adsb",
      "license": "ODbL 1.0 (ADSB.lol)",
      "confidence": "medium"
    }
  },
  "meta": {
    "request_id": "958b700e2d0dfe30"
  },
  "errors": []
}