Endpoints
| Path | Returns |
|---|---|
/api/health | Liveness + data freshness. 503 if the DB read fails or data is >30 min stale. |
/api/stats | Airborne counts, time span, altitude & speed ceilings, home + airport coords. |
/api/points | Heatmap points {points:[[lat,lon,w],…], count} (≤200k). |
/api/tracks | Per-flight polylines {tracks:[[[lat,lon],…]]}. |
/api/raw | Full rows {count, next, rows}, keyset-paginated via next → after. |
/api/detections | ADS-B ground-truth in a sensor-fusion shape (metres/ENU) for a time frame. GET/POST. |
/api/gps | GeoJSON GPS-interference hexes (gpsjam.org). ?day=YYYY-MM-DD optional. |
Filters (shared by /points, /tracks, /raw)
| Param | Meaning |
|---|---|
altmin altmax | Barometric altitude, feet. |
spdmin spdmax | Ground speed, knots. |
phase | climb | descend | level (vertical rate, ±1 m/s dead-band). |
callsign | Case-insensitive prefix, e.g. FIN. |
from to | Absolute window, unix seconds. |
since | Rolling window, hours back from the newest row. |
Units: filters take feet/knots,
but the returned columns are metric.
baro_alt/geo_alt come in
metres, velocity/vrate in m/s. A jet at
40 000 ft reads baro_alt≈12192.Examples
# Descending Finnair arrivals below 8000 ft, last 24 h curl 'https://api.flightradar.jaime.win/api/points?callsign=FIN&phase=descend&altmax=8000&since=24' # Bulk export; follow `next` until null curl 'https://api.flightradar.jaime.win/api/raw?since=24&limit=50000'
ADS-B ground-truth: /api/detections
Returns the real aircraft (with
identity) for a time frame, shaped like an RF sensor-fusion platform's
response, so you can line ADS-B truth up against a sensor's own detections
offline and score accuracy. This API only exposes ADS-B; it doesn't ingest
sensor tracks, so the comparison runs in your tooling. Altitude comes in
metres (WGS84), velocity m/s, radius km. Omit
timestamp for the newest frame. Center the area on the
airport, since the home point has no traffic.
# Aircraft within 15 km of the airport now, with local ENU
curl -X POST https://api.flightradar.jaime.win/api/detections \
-H 'Content-Type: application/json' \
-d '{"area":{"type":"radius","center":{"latitude":60.3172,"longitude":24.9633},"radius":15},"include_enu":true,"enu_reference":{"latitude":60.3172,"longitude":24.9633,"altitude":0}}'