FlyItalyADSB Events API

Emergencies and notable aircraft recorded by the network: emergency squawks, military, "interesting". https://flyitalyadsb.com/data/api/docs/alerts/

GitHub OpenAPI

Operations 1

GET /v2/events Emergencies and notable aircraft within a radius since a time #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/flyitalyadsb:flyitalyadsb-events-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

flyitalyadsb-events-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: FlyItalyADSB Events API
  version: '2'
  summary: Live and historical aircraft positions worldwide from the FlyItalyADSB community ADS-B/MLAT network. Commercial use allowed on every plan, Free included; the whole world in one request from the Pro plan (€49/month).
  description: 'Unfiltered aircraft data (no FAA/LADD/BARR filtering; military aircraft included, many of them via MLAT) from a global network of receivers run by volunteers (about 3,200 receivers, densest in North America and Europe; any point on Earth can be queried), as readsb aircraft.json records (the same format as tar1090), plus an ADS-B Exchange v2–compatible variant at /api/aircraft/v2. PIA and LADD aircraft are flagged in the dbFlags bit field (value 4 for PIA, 8 for LADD), so your product can hide them where its market or app store requires. Every endpoint except the key signup needs an X-Api-Key; keys are self-serve (see /auth.md). Plans and limits: https://flyitalyadsb.com/data/api/#piani. The same key works on the MCP server at https://flyitalyadsb.com/mcp. The same data is also served in the ADS-B Exchange v2 format (same paths, key headers and JSON; radius in nautical miles) at https://api.flyitalyadsb.com/api/aircraft/v2, documented at https://flyitalyadsb.com/data/api/docs/adsbx-v2/. Operated by Nesso Labs S.r.l. (ISO/IEC 27001:2022, QMSCERT 160426-7).'
  termsOfService: https://flyitalyadsb.com/terms/
  contact:
    name: Nesso Labs S.r.l. (FlyItalyADSB)
    email: info@flyitalyadsb.com
    url: https://flyitalyadsb.com/contact/
  license:
    name: 'Data: CC BY-SA 4.0'
    url: https://creativecommons.org/licenses/by-sa/4.0/
servers:
- url: https://api.flyitalyadsb.com
security:
- ApiKey: []
tags:
- name: Events
  description: 'Emergencies and notable aircraft recorded by the network: emergency squawks, military, "interesting". https://flyitalyadsb.com/data/api/docs/alerts/'
paths:
  /v2/events:
    get:
      summary: Emergencies and notable aircraft within a radius since a time
      description: 'Events recorded by the network: emergencies (squawk 7500/7600/7700 or the ADS-B emergency status, not "lifeguard"), military aircraft and "interesting" aircraft (dbFlags bits 0 and 1). One event per aircraft, kind and ~0.5° grid cell it entered, so a long flight appears once per cell; a new event for the same cell only after 30 (emergency) or 60 minutes away. Newest first. Counted as one request; the plan''s radius applies. https://flyitalyadsb.com/data/api/docs/alerts/'
      tags:
      - Events
      parameters:
      - name: lat
        in: query
        required: true
        description: Latitude, decimal degrees.
        schema:
          type: number
          minimum: -90
          maximum: 90
      - name: lon
        in: query
        required: true
        description: Longitude, decimal degrees.
        schema:
          type: number
          minimum: -180
          maximum: 180
      - name: dist
        in: query
        required: true
        description: Radius in km.
        schema:
          type: number
          exclusiveMinimum: 0
          maximum: 20040
      - name: since
        in: query
        description: Unix seconds or ISO 8601 (no zone = UTC). Default 24 hours ago, at most 7 days ago.
        schema:
          type: string
      - name: until
        in: query
        description: Unix seconds or ISO 8601. Default now.
        schema:
          type: string
      - name: kinds
        in: query
        description: Comma-separated subset of emergency, military, interesting. Default all.
        schema:
          type: string
      - name: limit
        in: query
        description: At most this many events (1–500, default 100).
        schema:
          type: integer
          minimum: 1
          maximum: 500
      responses:
        '200':
          description: Matching events.
          headers:
            X-FIA-Plan:
              $ref: '#/components/headers/X-FIA-Plan'
            X-FIA-Used-Month:
              $ref: '#/components/headers/X-FIA-Used-Month'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EventList'
        '400':
          description: A parameter is missing or out of range (the error says which).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          description: The radius is above the plan's maximum (the body carries max_radius_km and a link to the plans).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '503':
          description: Database unavailable, try again shortly.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: getV2Events
      x-operation-id-source: derived
components:
  headers:
    X-FIA-Plan:
      description: The key's plan (free, feeder, starter, pro, fleet, enterprise).
      schema:
        type: string
    X-FIA-Used-Month:
      description: Requests counted this month for the key.
      schema:
        type: integer
  schemas:
    EventList:
      type: object
      required:
      - now
      - since
      - until
      - count
      - truncated
      - events
      properties:
        now:
          type: number
        since:
          type: string
          format: date-time
        until:
          type: string
          format: date-time
        center:
          type: object
          properties:
            lat:
              type: number
            lon:
              type: number
        dist:
          type: number
        kinds:
          type: array
          items:
            type: string
        count:
          type: integer
        truncated:
          type: boolean
          description: More events matched than limit.
        events:
          type: array
          items:
            $ref: '#/components/schemas/TrafficEvent'
    Error:
      type: object
      required:
      - error
      properties:
        error:
          type: string
        code:
          type: string
        help:
          type: string
          format: uri
          description: 'On 401, 403 and 429: the FAQ answer for this error.'
      additionalProperties: true
    TrafficEvent:
      type: object
      description: An event, plus the aircraft fields known at that moment with readsb's names (flight, r, t, desc, year, alt_baro, gs, track, squawk, emergency, category, dbFlags); `source` is readsb's position type. Never the owner or operator.
      required:
      - id
      - kind
      - hex
      - time
      - lat
      - lon
      properties:
        id:
          type: integer
        kind:
          enum:
          - emergency
          - military
          - interesting
        reason:
          enum:
          - general
          - hijack
          - radio_failure
          - minimum_fuel
          - downed
          description: Emergencies only.
        hex:
          type: string
        time:
          type: string
          format: date-time
          description: When the aircraft was seen entering the cell.
        lat:
          type: number
        lon:
          type: number
        distance_km:
          type: number
          description: From the query point (or the webhook centre).
        source:
          type: string
          description: adsb_icao, mlat, …
        map:
          type: string
          format: uri
          description: The aircraft on the live map.
      additionalProperties: true
  responses:
    TooManyRequests:
      description: Per-minute limit (key or, on Free, IP) or the plan's monthly quota. Per-minute answers carry Retry-After.
      headers:
        Retry-After:
          description: Seconds to wait.
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Missing or invalid X-Api-Key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-Api-Key
      description: 'Self-serve: https://flyitalyadsb.com/data/api/#api-key'
externalDocs:
  description: 'API page: plans, endpoints, free key'
  url: https://flyitalyadsb.com/data/api/