BUILT FOR DEVELOPERS
ADS-B observations, recorded flight history and persistent tail-number subscriptions. Publicly available upcoming schedules are provided separately.
REST · JSON · WebSocket · OpenAPI 3.1Subscribe to a tail number using PUT /v1/subscriptions/{tail}. The collector follows that registration worldwide, without selecting a region. Remove it with DELETE /v1/subscriptions/{tail}. Monthly plans include 200 tails for $10, 1,000 for $50 or 5,000 for $100.
New subscriptions enter the collection queue within approximately 30 seconds, then wait their turn. Registrations shared by several customers are collected once per cycle. Worldwide tracking depends on observation availability. With a default 3-second request gap, more subscriptions increase collection latency. Spatial searches query stored observations; they do not trigger a regional or worldwide scan.
Create your account at /login, confirm the one-time email link and sign in. Your private workspace at /app includes API key generation and a Test API action. No password is required. Links expire after 15 minutes; sessions last 7 days.
Send your private key in the X-API-Key header. Generate a free key in your verified workspace: 1,000 requests per UTC day, 2 requests/second, 5 aircraft subscriptions, valid for 30 days. Operators can also create keys using flightinfo key-create. HTTP 429 indicates a limit was reached; respect the Retry-After response header.
Download the OpenAPI 3.1 specification for Swagger UI, Postman or a client generator. This documentation works without third-party scripts.
Loading example…
Demo and free-key traffic share an additional per-IP limit: 2 requests/second, burst 5, 1,000 requests/day UTC. Key rotation does not reset usage or subscriptions. Reverse proxies may share an IP budget.
WebSocket /v1/ws/subscriptions requires X-API-Key during the handshake and sends snapshots every 10 seconds. Each snapshot after the first consumes one request. Reconnect after one hour. Use a server-side client or BFF; browser WebSocket clients cannot set arbitrary headers.
Altitude is in ft, speed in kt, heading in degrees, and vertical rate in ft/min. All timestamps use UTC. stale indicates an old or missing observation. History contains observations recorded since collection began; default retention is 30 days. Source coverage and update frequency vary.
Use GET /v1/subscriptions/plans or GET /v1/tails/{tail}/plans for a subscribed aircraft. The job checks public profiles every 30 minutes by default, trying Flightradar24, FlightAware and RadarBox. no_upcoming_visible means no schedule is visible; unavailable means the source failed. Inspect stale and last_success. An empty result does not prove that no flights are planned. Schedule data is separate from ADS-B data and its license.