Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

ADS-B Exchange Live Positional Data API

Endpoints provide access to airborne or recently landed aircraft, as well as last known positions.Use these endpoints to get information about aircraft, such as location, flight, altitude, speed, and many more.Comprehensive filtering by various parameters is supported - such as ICAO hex code, registration, squawk, etc.See documentation to learn more about available endpoints and their parameters.For more information about properties returned, please navigate to Version 2 API Fields documentation.

ADS-B Exchange Live Positional Data API is one of 5 APIs that ADS-B Exchange publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Live Positional Data. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and rate-limit docs.

This API exposes 12 operations across 12 paths, and defines 13 schemas. It is described by OpenAPI 3.0.0, at version v2.

Requests are made against a single base URL, https://gateway.adsbexchange.com/api/aircraft/v2.

12 operations 12 paths 13 schemas 8 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
v2
Base URL
https://gateway.adsbexchange.com/api/aircraft/v2
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

ADS-B Exchange Live Positional Data API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (X-Api-Key).

  • X-Api-Key — Provide your API key via x-api-key header to access the API.

Paths & Operations 12

Across 12 paths, the API surfaces 12 operations — 8 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Live Positional Data 12

Endpoints provide access to airborne or recently landed aircraft, as well as last known positions. Use these endpoints to get information about aircraft, such as location, flight,…

GET
/all
Get all aircraft
GetApiAircraftV2All 1 param → 200402403429500
GET
/total-aircraft
Get total aircraft
GetApiAircraftV2TotalAircraft 1 param → 200402403429500
POST
/filter
Filter aircraft by criteria
PostApiAircraftV2Filter 1 param body → 200402403422429500
GET
/hex/{hex}
Get last known position
GetApiAircraftV2Hex 2 params → 200402403414429500
POST
/hex
Get last known position
PostApiAircraftV2Hex 1 param body → 200402403429500
GET
/icao/{icao}
Get aircraft by ICAO
GetApiAircraftV2Icao 2 params → 200402403414429500
POST
/icao
Get aircraft by ICAO
PostApiAircraftV2Icao 1 param body → 200402403429500
GET
/mil
Get military aircraft
GetApiAircraftV2Mil 1 param → 200402403429500
GET
/callsign/{callsign}
Get aircraft by callsign
GetApiAircraftV2Callsign 2 params → 200402403429500
GET
/registration/{registration}
Get aircraft by registration
GetApiAircraftV2Registration 2 params → 200402403429500
POST
/registration
Get aircraft by registrations
PostApiAircraftV2Registration 1 param body → 200402403429500
GET
/sqk/{squawk}
Get aircraft by squawk
GetApiAircraftV2Sqk 2 params → 200402403429500

Schemas 13

The contract defines 13 schemas that model the data the API accepts and returns. The most detailed are AircraftSingleResponse (60 properties), AcasResolutionAdvisoryResponse (11 properties), AircraftCollectionResponse (6 properties), ProblemDetails (5 properties). Each schema is shown below with its type and property counts.

AircraftRequest
object
Model for querying api for multiple aircraft hexes
1 property
RegistrationRequest
object
Model for querying api for multiple aircraft by registration numbers
1 property
AcasResolutionAdvisoryResponse
object
ACAS Resolution Advisory Class
11 properties
RequestedUrlTooLongResponse
object
Requested URL is too long.
1 property
ApiTooManyRequestsResponse
object
1 property
AircraftSingleResponse
object
Full aircraft model with all available information.
60 properties
ApiUnauthorizedResponse
object
2 properties
ApiForbiddenResponse
object
2 properties
LastPositionDataResponse
object
When the regular lat and lon are older than 60 seconds they are no longer considered valid, this will provide the last position and show the age for the last p…
5 properties
AircraftCollectionResponse
object
Response envelope for the multiple aircraft endpoint.
6 properties
FilterDefinition
object
3 properties
ProblemDetails
object
5 properties
FilterRequest
object
Model describing filter criteria for live aircraft data.
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

adsbexchange-live-positional-data-api-openapi.yml Raw ↑

Other APIs ADS-B Exchange publishes across the network.

ADS-B Exchange Geopolitical Filtering API
ADS-B Exchange Geospatial Filtering API
ADS-B Exchange Operations API
ADS-B Exchange Traces API