Skip to content
Documentation · Changelog
Documentation /

Changelog

What's new in the FlyItalyADSB REST API and MCP server, newest first: endpoints, tools, limits and fixes, each with its date.

Updated

DateWhat’s new
08/11/2026The extras follow the plan. Free includes live positions, lookups and lists, the flight history and tracks of the last 7 days, commercial use and the MCP server. Overflights, emergencies and notable aircraft, the runway in use and area alerts start from Starter; tracks go back 30 days on Starter, 90 on Pro, to 2022 on Fleet. New error codes plan-feature, tracks-depth, events-depth (403) and area-webhook-limit (409), here. They apply right away to keys created from today; to existing keys from the day given in the notice email.
08/11/2026The Business plan is gone: the self-serve plans are Free, Starter, Pro and Fleet. For more than 25 watched aircraft, more volume, an SLA or to resell the data as an API or feed, get in touch.
08/11/2026MCP server, on Fleet: watched_aircraft (list, add or remove the watched aircraft from the chat) and fleet_status (today’s flights of each watched aircraft, with the last airport and an estimated arrival when flying); observed_flights also returns today’s flights. MCP server.
07/11/2026The Fleet plan, €149 a month + tax: Pro’s limits (300 requests a minute, 10 million a month, the whole world), 90 days of observed flights, up to 25 watched aircraft with takeoff and landing webhooks, and today’s flights with an estimated arrival time. Business (€249) is Fleet with 250 aircraft, 1,000 requests a minute, 50 million a month and 12 months of observed flights. Plans.
07/11/2026Your aircraft, on Fleet and Business: /v2/watch (the account’s watched aircraft, by ICAO address, registration or callsign) and webhooks with kinds: ["takeoff", "landing"], which send flight.takeoff, flight.landing and flight.landing_retracted as the network detects them. /v2/flights/icao, /reg and /callsign also carry today, today’s flights with an estimated arrival time. Your aircraft, today’s flights.
07/11/2026List options on /v2: ?fields= (only the fields you ask for; fields=light for maps and displays), ?with=route (each aircraft’s most frequent route in the observed flights), /v2/box/{lat_south}/{lat_north}/{lon_west}/{lon_east} (the aircraft in a box, across the 180° meridian too), up to 50 aircraft in one request counted once (/v2/icao/a,b,c, and the same on /hex, /reg, /callsign), ?since= on /v2/history/{icao}/{date} (only the points after a time). List options.
07/11/2026Runway in use: /v2/airport/{code}/runways, the runway an airport is using now, estimated from the aircraft near it. Runway in use.
07/11/2026Observed flights: find your flight by route (/v2/flights/route/{from}/{to}?around=HH:MM), an aircraft’s flight log as CSV (?format=csv), and how far back each plan goes: Free 7 days, Starter 14, Pro 30, Business 12 months; beyond, a 403 with code flights-depth, not counted. Observed flights.
06/11/2026When you request a key: two more questions, who the data is for (audience) and whether you already use another flight data source (other_source), plus, if an AI assistant brought you here, what you asked it (ai_prompt, optional). Required in the form; in POST /v2/keys accepted now and required soon. Authentication.
06/11/2026Observed flights: /v2/flights/callsign/{callsign} (a callsign’s flights and usual routes), /v2/flights/icao/{hex} and /v2/flights/reg/{reg} (one aircraft’s flight log, with a summary for flight hours), /v2/flights/airport/{code} (departures and arrivals of a day), built every night from the network’s own tracks, and the MCP tool observed_flights. When a live lookup finds nothing, its 404 carries last_seen, the last flight observed. Observed flights.
06/11/2026More tolerant lookups: /v2/callsign also tries flight numbers (FR5518 finds RYR5518) and callsigns without leading zeros, /v2/reg ignores dashes, /v2/hex is an alias of /v2/icao, and the new /v2/find/{text} tries callsign, registration and ICAO address. A 404 says what was tried and why. find_aircraft on the MCP server no longer needs to know which identifier it has. Callsign and flight number.
02/11/2026The map and the API refresh every half second (before: every 2–3 seconds), from the same picture: on the map aircraft move smoothly also over the busiest areas.
27/10/2026The ADS-B Exchange v2 format at https://api.flyitalyadsb.com/api/aircraft/v2: the same paths, key headers (api-auth, X-RapidAPI-Key) and JSON as ADS-B Exchange v2, plus /point and /closest, so code written for it only changes host and key. /v2 is unchanged.
26/10/2026/v2/sqk/{squawk} (also /v2/squawk/) and /v2/type/{type}; list answers also carry total. A table of the differences from ADSBx v2.
27/10/2026Coming: the Free plan’s per-key limits take effect (until then only the per-IP limit applies).
25/10/2026The map in the chat shows all the traffic in the area you are looking at, also when you move it, and Live is on from the start: an update every 3 seconds.
22/10/2026A map in the chat: on Claude and ChatGPT, the MCP tools that return aircraft also show them on an interactive map.
22/10/2026Notable traffic: /v2/events (emergencies 7500/7600/7700, military and other notable aircraft by area, up to 7 days) and the MCP tool notable_traffic. On paid plans, signed webhook alerts (Alerts).
22/10/2026Overflights: /v2/overflights and the MCP tool overflights, the aircraft that flew over a place between two times (since 17/08/2026).
22/10/2026Aircraft profile: /v2/profile/{icao} and the MCP tool aircraft_profile.
22/10/2026”Near me” on the MCP server: the position saved on the account (set_my_location, My API), or ChatGPT’s city. Agent registration with auth.md. Documentation and FAQ.
21/10/2026OAuth on the MCP server: Claude and other assistants connect with Connect, without copying keys.
20/10/2026Feeder perk: Pro limits for free on the Free keys of people who feed the network, for non-commercial use.
19/10/2026Self-serve paid plans: Starter, Pro, Business.
18/10/2026History also covers 2022–2024.
02/09/2026Self-serve history: /v2/history/{icao} and /v2/history/{icao}/{date}.
31/08/2026REST API v2 and MCP server.