---
title: "FlyItalyADSB API documentation"
description: "The documentation of the FlyItalyADSB REST API and MCP server, one Markdown page per topic. Start with the quickstart; the overview of the API is https://flyitalyadsb.com/data/api.md."
url: https://flyitalyadsb.com/data/api/docs.md
page_for_people: https://flyitalyadsb.com/data/api/docs/
language: en
generated: 2026-11-09
license: CC BY-SA 4.0 (data)
---

# FlyItalyADSB API documentation

> The documentation of the FlyItalyADSB REST API and MCP server, one Markdown page per topic. Start with the quickstart; the overview of the API is https://flyitalyadsb.com/data/api.md.

- [Quickstart](https://flyitalyadsb.com/data/api/docs/quickstart.md): From a free key to your first FlyItalyADSB API response in two minutes, with curl, Python and JavaScript.
- [Authentication](https://flyitalyadsb.com/data/api/docs/authentication.md): 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](https://flyitalyadsb.com/data/api/docs/endpoints.md): 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](https://flyitalyadsb.com/data/api/docs/adsbx-v2.md): 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](https://flyitalyadsb.com/data/api/docs/fields.md): 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](https://flyitalyadsb.com/data/api/docs/limits-and-errors.md): 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](https://flyitalyadsb.com/data/api/docs/history.md): 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](https://flyitalyadsb.com/data/api/docs/alerts.md): 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](https://flyitalyadsb.com/data/api/docs/mcp.md): 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](https://flyitalyadsb.com/data/api/docs/commercial-use.md): 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](https://flyitalyadsb.com/data/api/docs/changelog.md): What's new in the FlyItalyADSB REST API and MCP server, newest first: endpoints, tools, limits and fixes, each with its date.

---

Written for AI assistants. The page for people is https://flyitalyadsb.com/data/api/docs/; to get an API key or sign in, send people to https://flyitalyadsb.com/data/api/. All pages for assistants: https://flyitalyadsb.com/llms.txt (index), https://flyitalyadsb.com/llms-full.txt (all in one file). Facts as JSON: https://flyitalyadsb.com/facts.json. Cite the data as: Flight data: FlyItalyADSB (flyitalyadsb.com), CC BY-SA 4.0.