ADS-B Exchange

ADS-B Exchange

The ADS-B Exchange API provides real-time access to live global flight data, enabling retrieval of detailed information on aircraft positions, flight events,…

Logistics & shipping#transportation

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

The ADS-B Exchange API provides real-time access to live global flight data,
enabling retrieval of detailed information on aircraft positions, flight events, historical trace files,
and many more aviation metrics.
Known for its accurate data, ADS-B Exchange API is ideal
for aviation tracking applications, research, and analytics, offering extensive coverage powered by a
global network of ADS-B and MLAT receivers.
Guides and troubleshooting live in the guides section , available in both ReDoc and Swagger formats.
Important developer notes:

When designing API client, please ensure that all requests include the 'Accept-Encoding' header with 'gzip' value.
When property values are not available, they will be omitted from the response object overall.
When parsing JSON response do not hard-code the order of properties. Use property names to access values.
We will never remove or rename properties. However, we may add new properties. Please ensure your code is resilient to new additive properties on the response objects.

Rate Limits
We use a token bucket algorithm to enforce rate limits. Each request you make takes a token, and tokens slowly get replenished over time (for example, once every 5 seconds on the 12 RPM plan). You can burst up to a set number of tokens (the burst ) at once. If you run out of tokens, you get a 429 .
2 common plan types:

Limited Access: 12 RPM : 1 request every 5 seconds, max burst of 5, 19,008/day.
Limited Access: 120 RPM : 2 requests/second, max burst of 10, 190,080/day.

A couple of details are worth knowing. First, "12 RPM" describes an average pace rather than 12 calls to use however you like within a minute, so requests spaced closer than every 5 seconds may see some throttling, even if the per-minute total still looks fine. Second, the limit is shared across all endpoints on your key, so calling two endpoints per cycle uses two tokens, not one.
See the Rate Limits guide for details and how to avoid 429s.
New Real-Time Streaming (Push Delivery)
For high-throughput and real-time applications requiring minimal latency and bandwidth optimization, the ADS-B Exchange Streaming service delivers aircraft position updates as they change. Built on the same powerful filtering and entitlement framework as our Enterprise API, streaming provides a more efficient way to consume live aviation data.

Endpoints 30

Live Positional Data

  • GETGet all aircraft/allReturns all aircraft currently being tracked. Note: This endpoint can be slow or unresponsive in Swagger UI due to the large volume of data returned. For best…
  • GETGet total aircraft/total-aircraftReturns only count of aircraft currently being tracked.
  • POSTFilter aircraft by criteria/filterFilters and returns only aircraft that match the provided criteria. Filter contains of a list of filter definitions and a logical operator that defines how…
  • GETGet last known position/hex/:hexThis endpoint will return a last known position for the aircraft. Each aircraft model will contain the "now" property (unix timestamp, milliseconds) denoting…
  • POSTGet last known position/hexThis endpoint will return a last known position for the aircraft. Because GET request has a limit on the number of characters in the URL, it is recommended to…
  • GETGet aircraft by ICAO/icao/:icaoThis endpoint will return aircraft data for the provided ICAO code(s). This will not return a match if aircraft has not been seen by ADS-B Exchange in the…
  • POSTGet aircraft by ICAO/icaoThis endpoint will return aircraft data for the provided ICAO code(s). This will not return a match if aircraft has not been seen by ADS-B Exchange in the…
  • GETGet military aircraft/milThis endpoint will return only military aircraft.
  • GETGet aircraft by callsign/callsign/:callsignThis endpoint will return aircraft data for the provided callsign(s).
  • GETGet aircraft by registration/registration/:registrationThis endpoint will return aircraft data for the provided registration number(s).
  • POSTGet aircraft by registrations/registrationThis endpoint will return aircraft data for the provided registration number(s). Because GET request has a limit on the number of characters in the URL, it is…
  • GETGet aircraft by squawk/sqk/:squawkThis endpoint will return aircraft data for the provided squawk code(s).

Geospatial Filtering

  • GETGet aircraft in radius/lat/:lat/lon/:lon/dist/:distThis endpoint will return aircraft data within the given radius (NM) of the provided coordinates. Get aircraft within 50 nautical miles of San Francisco: GET…
  • POSTGet aircraft in radius/proximity/radiusThis endpoint will return aircraft data within the given radius (NM) of the provided points. Get aircraft within 50 nautical miles of San Francisco, and…
  • GETGet aircraft in radius (minimal)/minimal/lat/:lat/lon/:lon/dist/:distThis endpoint will return aircraft data within the given radius (NM) of the provided coordinates. The data will be returned in a minimal representation.
  • GETGet aircraft in radius (above altitude)/nohex/dist/:dist/above/:alt/lat/:lat/lon/:lonThis endpoint will return aircraft data within the given radius (NM) of the provided coordinates, and above the provided altitude (ft). Get aircraft within 50…
  • GETGet aircraft near the airport/airport/:airportThis endpoint will return aircraft data within 5 nautical miles of the provided airport ICAO code. Get aircraft within 5 nautical miles of San Francisco…
  • POSTGet aircraft near airports/airportThis endpoint will return aircraft data within 5 nautical miles of the provided airport ICAO code(s). Get aircraft within 5 nautical miles of San Francisco…
  • POSTGet aircraft within boundary/geospatial/boundaryReturns all aircraft within the given geospatial boundary(ies) described by GeoJSON Features. The boundary is defined as a GeoJSON "FeatureCollection" object…

Geopolitical Filtering

  • GETGet aircraft by country/geospatial/country/:countryReturns aircraft within the boundaries of the given country. See below examples of how to query aircraft by country. Country must be specified as ISO 3166-1…
  • GETGet subdivisions by country code/geospatial/country/:country/subdivisionsWhe country code is provided, this endpoint will return a list of state/province subdivisions for the given country. This endpoint is complimentary to…
  • GETGet aircraft by country subdivision: state/province/geospatial/country/:country/subdivision/:subdivisionReturns aircraft within the boundaries of the given country's subdivision: state or province. * Country must be specified as ISO 3166-1 alpha-2 code. *…
  • GETGet aircraft by geographical region/geospatial/region/:regionReturns aircraft within the boundaries of the given geographical region. Supported regions: * Northern/Eastern/Southern/Western Europe * North/Central/South…
  • GETGet aircraft by continent/geospatial/continent/:continentReturns aircraft within the boundaries of the given continent. Supported continents: * Americas * Africa * Asia * Europe * Oceania * Antarctica To filter by…

Traces

  • GETGet recent trace file/traces/:folder/:jsonFileReturns the trace file for the aircraft with the specified ICAO code. The trace file contains aircraft position history starting 00:00 UTC today. Must begin…
  • GETGet historical trace file/traces-hist/:year/:month/:day/traces/:folder/:jsonFileReturns the trace file for the aircraft with the specified ICAO code. The trace file contains aircraft position history before UTC today. For getting the…

Operations

  • POSTGet operations by multiple aircraft ICAO codes/operations/icaosReturns operations (Takeoffs and Landings) for the given ICAO codes. Response is paginated and sorted by time (descending). Returns 1000 items per page. Max…
  • GETGet operations by aircraft/operations/icao/:icaoReturns operations (Takeoffs and Landings) for the given ICAO code (hex code) of the aircraft. Response is paginated and sorted by time (descending). Returns…
  • POSTGet operations by multiple airports/operations/airportsReturns operations (Takeoffs and Landings) for the given ICAO codes of the airports. Response is paginated and sorted by time (descending). Returns 1000 items…
  • GETGet operations by airport/operations/airport/:airportReturns operations (Takeoffs and Landings) for the given ICAO code of the airport. Response is paginated and sorted by time (descending). Returns 20 items per…

API details

Base URL
https://gateway.adsbexchange.com/api/aircraft/v2
Authentication
An API key in the x-api-key header
Operations
30 operations on 30 pathsGET 21POST 9
Main resources
Live Positional Data 12Geospatial Filtering 7Geopolitical Filtering 5Operations 4Traces 2
Response formats
application/json
Description format
OpenAPI 3.0.0, API version v2

How to test the ADS-B Exchange in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the ADS-B Exchange collection, without the publisher's secrets.
  3. Add your credentialsThis API uses an API key in the x-api-key header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Get all aircraft” (GET /all), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the ADS-B Exchange?

The ADS-B Exchange API provides real-time access to live global flight data, enabling retrieval of detailed information on aircraft positions, flight events,… It is listed under Logistics & shipping and has 30 endpoints.

Who publishes the ADS-B Exchange?

It is listed from ADS-B Exchange's public API description (an OpenAPI document), not published by ADS-B Exchange on Swastik Codes. Anyone who controls adsbexchange.com can claim the profile by adding a DNS TXT record.

What is the base URL of the ADS-B Exchange?

Requests go to https://gateway.adsbexchange.com/api/aircraft/v2. Endpoint paths are added to this base URL.

How do I authenticate with the ADS-B Exchange?

With an API key in the x-api-key header.

How many endpoints does the ADS-B Exchange have?

30 operations on 30 paths (21 GET, 9 POST). The largest groups are Live Positional Data, Geospatial Filtering, Geopolitical Filtering, Operations.

Is forking the ADS-B Exchange free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.