How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
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.2.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.2.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), LastPositionDataResponse (5 properties). Each schema is shown below with its type and property counts.

AcasResolutionAdvisoryResponse
object
ACAS Resolution Advisory Class
11 properties
RequestedUrlTooLongResponse
object
Requested URL is too long.
1 property
AircraftRequest
object
Model for querying api for multiple aircraft hexes
1 property
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
ApiUnauthorizedResponse
object
2 properties
AircraftCollectionResponse
object
Response envelope for the multiple aircraft endpoint.
6 properties
AircraftSingleResponse
object
Full aircraft model with all available information.
60 properties
ApiForbiddenResponse
object
2 properties
RegistrationRequest
object
Model for querying api for multiple aircraft by registration numbers
1 property
FilterRequest
object
Model describing filter criteria for live aircraft data.
2 properties
ApiTooManyRequestsResponse
object
1 property
FilterDefinition
object
3 properties
ProblemDetails
object
5 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
Where this information came from

This is an independent, third-party profile of ADS-B Exchange Live Positional Data API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.