API Documentation
RESTful API for querying real-time aircraft positions. Compatible with adsb.lol v2 API format.
Authentication
All API requests require a valid feeder UUID in the X-ADSBiq-Key header. You get your UUID when you install the feeder.
curl -H "X-ADSBiq-Key: YOUR-UUID-HERE" https://adsbiq.com/api/v2/allEndpoints
/api/v2/all
Full aircraft snapshot. Returns all currently tracked aircraft.
/api/v2/hex/{hex}
Single aircraft by ICAO 24-bit hex code (e.g., A12345).
/api/v2/reg/{reg}
Aircraft by registration (e.g., N12345).
/api/v2/type/{type}
Aircraft by ICAO type designator (e.g., B738, A320).
/api/v2/callsign/{callsign}
Aircraft by callsign/flight number (e.g., UAL123).
/api/v2/lat/{lat}/lon/{lon}/dist/{nm}
Aircraft within a radius. Distance in nautical miles. Example: /api/v2/lat/26.68/lon/-80.10/dist/50
/api/v2/mil
Military aircraft only (based on database flags).
/api/v2/squawk/{code}
Aircraft by squawk code (e.g., 7700).
Response Format
{
"now": 1711036800.0,
"messages": 12345678,
"ac": [
{
"hex": "a12345",
"type": "adsb_icao",
"flight": "UAL123 ",
"r": "N12345",
"t": "B738",
"alt_baro": 35000,
"alt_geom": 35200,
"gs": 450.2,
"track": 270.5,
"lat": 26.7153,
"lon": -80.0534,
"seen": 0.3,
"rssi": -15.2,
"messages": 1234
}
],
"total": 1,
"ctime": "2026-03-21T12:00:00+00:00"
}Key Fields
| Field | Description |
|---|---|
hex | ICAO 24-bit address (lowercase hex) |
flight | Callsign (8 chars, space-padded) |
r | Registration |
t | ICAO type designator |
alt_baro | Barometric altitude (feet) |
gs | Ground speed (knots) |
lat/lon | Position (WGS84) |
track | Track angle (degrees) |
seen | Seconds since last message |
rssi | Signal strength (dBFS) |
dbFlags | 1=military, 2=interesting, 4=PIA, 8=LADD |
Rate Limits
Active feeders (data received in the last 24 hours) have unlimited API access. No rate limiting.
Non-feeders: API access is restricted. Become a feeder to get your free API key.