Aviation Data

Live aircraft states

Live ADS-B-derived aircraft states from ADSB.lol.

GET/v1/tracking/statesRequires X-API-Key

Bounding-box (`min_lat`, `max_lat`, `min_lon`, `max_lon`) and `icao24` filters supported. When no bounding box is given the endpoint returns an empty list (no global dumps). Returns a 429 error in the `errors` array when ADSB.lol throttles the request.

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

min_latnumber

Southern bound.

max_latnumber

Northern bound.

min_lonnumber

Western bound.

max_lonnumber

Eastern bound.

icao24string

Comma-separated icao24 hex addresses.

Request

GET

BASH·cURL

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

API Key

Query parameters

min_lat

max_lat

min_lon

max_lon

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",
      "category": "A3",
      "provenance": {
        "source": "adsblol",
        "source_type": "derived-from-adsb",
        "license": "ODbL 1.0 (ADSB.lol)",
        "confidence": "medium"
      }
    }
  ],
  "meta": {
    "request_id": "f8c2e38e5543d811",
    "count": 1,
    "total": 1,
    "last_updated": "2026-05-30T12:12:09Z"
  },
  "errors": []
}