API documentation
FlyItalyADSB REST API and MCP server docs: quickstart, authentication, endpoints, fields and units, limits and errors, history, commercial use.
Everything you need to use the API and the MCP server. For a quick question, check the FAQ.
Quickstart From a free key to your first FlyItalyADSB API response in two minutes, with curl, Python and JavaScript. Authentication An API key in X-Api-Key, OAuth for AI assistants, and agent registration with auth.md: how to get and manage access to the FlyItalyADSB API. Endpoints Every FlyItalyADSB REST API v2 endpoint: aircraft by hex, callsign or registration (flight numbers too, up to 50 in one request), within a radius or a box, by squawk or type, military, PIA, LADD, tracks, profile, overflights, flight history and today's flights, watched aircraft, the runway in use; list options; differences from ADSBx v2. ADS-B Exchange v2 compatibility Use FlyItalyADSB in place of the ADS-B Exchange v2 API: same paths, same key headers, same JSON (ac, msg, now, total, ctime, ptime). Change the host and the key, nothing else. Fields and units An aircraft's fields in the API (readsb aircraft.json) and their units: altitude in feet or "ground", speed in knots, dbFlags, seen_pos, position source. Limits and errors API limits per plan (per minute, per month, radius, how far back the flight history goes), how they're counted, the X-FIA-* headers, and what to do about 400-429 errors and Cloudflare blocks. Tracks and overflights ADS-B tracks via the API: an aircraft's dates with a track, one day's track, overflights (aircraft that flew over a place), coverage since 2022, and what's missing. Alerts, emergencies and your aircraft Emergencies and notable aircraft with /v2/events (emergency squawks, military and rare aircraft by area), the takeoffs and landings of your own aircraft (Fleet), and alerts by signed webhook, checked in Python and JavaScript. MCP server The MCP server at flyitalyadsb.com/mcp: its tools, “near me”, how to connect Claude, Claude Code and other clients, and how requests are counted. Commercial use The FlyItalyADSB API in apps and devices you sell: one key per product, caching on your server, the right plan, CC BY-SA 4.0 attribution, when to get in touch. Changelog What's new in the FlyItalyADSB REST API and MCP server, newest first: endpoints, tools, limits and fixes, each with its date.