ADS-B Exchange live aircraft of one type API
Use the ADS-B Exchange live aircraft of one type API to retrieve aircraft records and geographic coordinates as structured JSON from ADS-B Exchange. Supply record type in the query. Use these results to inspect tracked aircraft positions and prepare an aviation map with the returned observation times. Continue with the returned next_offset as offset; a null value marks the last page. The detail page includes parameter definitions, paired request and response examples, and usage pricing for this operation.
- Selected price
- $0.002 / billing creditPublished pricing
- Sellers / implementations
- 1 / 1
- Requests · 30d
- —Loading...
- Success rate · 30d
- —Loading...
| Seller | Pricing | Requests · 30d | Performance | Access |
|---|---|---|---|---|
apishCurrent ADS-B Exchange live aircraft of one type API · GET · View API reference | $0.002 / billing credit | — | —successP50— |
Run sends a real API request. Charges follow the published API contract.
Response structure
aircraftobject[]adsb_versionnullaircraft_typestringaltitude_baro_ftintegeraltitude_geom_ftnullcallsignstringcategorynullemergencynullground_speed_ktnullhexstringindicated_airspeed_ktnullinterestingbooleanlatitudenumberlongitudenumbermachnullmagnetic_heading_degnullmessagesintegermilitarybooleannac_pnullnac_vnullnicintegeron_groundbooleanoutside_air_temp_cnullqnh_hpanullreceiversintegerregistrationstringroll_degnullrssinumbersdanullseconds_since_positionnumberseconds_since_seennumberselected_altitude_fms_ftnullselected_altitude_ftnullselected_heading_degnullsilnullsourcestringsquawknulltotal_air_temp_cnulltrack_degnumbertrack_ratenulltrue_airspeed_ktnulltrue_heading_degnullvertical_rate_baro_fpmnullvertical_rate_geom_fpmnullwind_direction_degnullwind_speed_ktnull
cachedbooleancountintegercredits_usedintegerfetched_atstringnext_offsetintegeroffsetintegertimestringtotalintegertypestring
// Inferred from response examples. Fields are optional and other fields may be returned.
export type ApiResponse = {
aircraft?: Array<{
adsb_version?: null;
aircraft_type?: string;
altitude_baro_ft?: number;
altitude_geom_ft?: null;
callsign?: string;
category?: null;
emergency?: null;
ground_speed_kt?: null;
hex?: string;
indicated_airspeed_kt?: null;
interesting?: boolean;
latitude?: number;
longitude?: number;
mach?: null;
magnetic_heading_deg?: null;
messages?: number;
military?: boolean;
nac_p?: null;
nac_v?: null;
nic?: number;
on_ground?: boolean;
outside_air_temp_c?: null;
qnh_hpa?: null;
receivers?: number;
registration?: string;
roll_deg?: null;
rssi?: number;
sda?: null;
seconds_since_position?: number;
seconds_since_seen?: number;
selected_altitude_fms_ft?: null;
selected_altitude_ft?: null;
selected_heading_deg?: null;
sil?: null;
source?: string;
squawk?: null;
total_air_temp_c?: null;
track_deg?: number;
track_rate?: null;
true_airspeed_kt?: null;
true_heading_deg?: null;
vertical_rate_baro_fpm?: null;
vertical_rate_geom_fpm?: null;
wind_direction_deg?: null;
wind_speed_kt?: null;
}>;
cached?: boolean;
count?: number;
credits_used?: number;
fetched_at?: string;
next_offset?: number;
offset?: number;
time?: string;
total?: number;
type?: string;
};- Method
- GET
- Endpoint
https://api.openany.si/v1/agent-apis/apish/adsbexchange/v1/type- Content type
- application/json
- Authentication
Authorization: Bearer $OPENANY_API_KEY
curl \
'https://api.openany.si/v1/agent-apis/apish/adsbexchange/v1/type?limit=1&output=json&raw=0&type=A388' \
-X GET \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json'Input parameters
Fields in this listing; additional options and input encoding can vary by provider.
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
type | URL query parametersquery | string | Yes | ICAO type designator, e.g. `A388`, `B744`, `C17`. |
limit | URL query parametersquery | integer | No | Aircraft per page (1-500, default 100). |
offset | URL query parametersquery | integer | No | Skip this many aircraft. |
raw | URL query parametersquery | string | No | 0 leaves out the bulky `raw` source blocks (often 10-30x smaller). enum: "0", "1" |
fields | URL query parametersquery | string | No | Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included. |
fresh | URL query parametersquery | string | No | 1 skips the 24-hour cache and fetches live. enum: "1" |
output | URL query parametersquery | string | No | JSON only for this OpenAny product. Omit output or use json; CSV and NDJSON are not supported. enum: "json" |
records | URL query parametersquery | string | No | With output=csv|ndjson: the top-level list to turn into rows (e.g. `reviews`), or `.` for the whole object as one row. |
Required markers inside a nested object or variant apply when that object or variant is used.
Sample response
Sample response · Documented HTTP 200 Example from the provider's documentation. Field values in your results will differ.
{
"aircraft": [
{
"adsb_version": null,
"aircraft_type": "A388",
"altitude_baro_ft": 36000,
"altitude_geom_ft": null,
"callsign": "QFA12",
"category": null,
"emergency": null,
"ground_speed_kt": null,
"hex": "7c4922",
"indicated_airspeed_kt": null,
"interesting": false,
"latitude": -0.1667,
"longitude": -148.2667,
"mach": null,
"magnetic_heading_deg": null,
"messages": 0,
"military": false,
"nac_p": null,
"nac_v": null,
"nic": 0,
"on_ground": false,
"outside_air_temp_c": null,
"qnh_hpa": null,
"receivers": 1,
"registration": "VH-OQC",
"roll_deg": null,
"rssi": -20.5,
"sda": null,
"seconds_since_position": 1224.6,
"seconds_since_seen": 1224.6,
"selected_altitude_fms_ft": null,
"selected_altitude_ft": null,
"selected_heading_deg": null,
"sil": null,
"source": "adsc",
"squawk": null,
"total_air_temp_c": null,
"track_deg": 223.3,
"track_rate": null,
"true_airspeed_kt": null,
"true_heading_deg": null,
"vertical_rate_baro_fpm": null,
"vertical_rate_geom_fpm": null,
"wind_direction_deg": null,
"wind_speed_kt": null
}
],
"cached": false,
"count": 1,
"credits_used": 1,
"fetched_at": "2026-11-19T12:23:53.581Z",
"next_offset": 1,
"offset": 0,
"time": "2026-11-19T12:23:53.001Z",
"total": 59,
"type": "A388"
}Composite rule pricing
Calculated from input parameters and actual returned quantities. Estimate the maximum cost before calling.
Base fee: $0.000000. One matching variant replaces the base fee. Matching add-ons and quantity charges are added.
| Fee item | Price | Metering source | When | Quantity limit |
|---|---|---|---|---|
| Actual API.SH credits consumed | $0.002000 / billing credit | Response · /credits_used · Numeric value | Always | 1 billing credit · Decimal places: 0 |
Each quantity charge is rounded before summing: ceil. Requests exceeding this cost limit are rejected; it is not a price cap: $0.002000.
Response quantities settle after the response. Before execution, the maximum quantity determines the reservation; unused reservation is released. Missing or invalid quantities are not treated as zero.
Pricing parameters and defaults
[]
Agent integration
Copy the resource contract without sharing an API key.
View API Markdown
# ADS-B Exchange live aircraft of one type API
Use the ADS-B Exchange live aircraft of one type API to retrieve aircraft records and geographic coordinates as structured JSON from ADS-B Exchange. Supply record type in the query. Use these results to inspect tracked aircraft positions and prepare an aviation map with the returned observation times. Continue with the returned next_offset as offset; a null value marks the last page. The detail page includes parameter definitions, paired request and response examples, and usage pricing for this operation.
Documentation: https://openany.si/apis/7896e67d-1a7d-4947-a1e6-1549c2e075d6
Method: GET
Endpoint: https://api.openany.si/v1/agent-apis/apish/adsbexchange/v1/type
Price: $0.002 / billing credit
Provider: apish
Contract revision: 2
Price source: OpenAny public API contract and documented provider unit rates. Price update time: not supplied.
Use OPENANY_API_KEY from the environment. API Key calls use your shared balance.
## Prepared request
```bash
curl \
'https://api.openany.si/v1/agent-apis/apish/adsbexchange/v1/type?limit=1&output=json&raw=0&type=A388' \
-X GET \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json'
```
## API contract
```json
{
"resource_type": "api",
"name": "ADS-B Exchange live aircraft of one type API",
"endpoint": "https://api.openany.si/v1/agent-apis/apish/adsbexchange/v1/type",
"method": "GET",
"content_type": "none",
"execution_mode": "sync",
"authentication": {
"type": "bearer",
"environment_variable": "OPENANY_API_KEY"
},
"inputs": [
{
"description": "ICAO type designator, e.g. `A388`, `B744`, `C17`.",
"location": "query",
"name": "type",
"nullable": false,
"required": true,
"type": "string"
},
{
"description": "Aircraft per page (1-500, default 100).",
"location": "query",
"name": "limit",
"nullable": false,
"required": false,
"type": "integer"
},
{
"description": "Skip this many aircraft.",
"location": "query",
"name": "offset",
"nullable": false,
"required": false,
"type": "integer"
},
{
"description": "0 leaves out the bulky `raw` source blocks (often 10-30x smaller).",
"enum_values": [
"0",
"1"
],
"location": "query",
"name": "raw",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included.",
"location": "query",
"name": "fields",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "1 skips the 24-hour cache and fetches live.",
"enum_values": [
"1"
],
"location": "query",
"name": "fresh",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "JSON only for this OpenAny product. Omit output or use json; CSV and NDJSON are not supported.",
"enum_values": [
"json"
],
"location": "query",
"name": "output",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "With output=csv|ndjson: the top-level list to turn into rows (e.g. `reviews`), or `.` for the whole object as one row.",
"location": "query",
"name": "records",
"nullable": false,
"required": false,
"type": "string"
}
],
"billing": {
"currency": "USD",
"mode": "rules",
"parameters": [],
"policy_version": 2,
"sale": {
"addons": [],
"base_price_micro_usd": "0",
"max_cost_micro_usd": "2000",
"quantities": [
{
"id": "upstream_credits",
"label": "Actual API.SH credits consumed",
"max_quantity": "1",
"measure": "value",
"pointer": "/credits_used",
"price_micro_usd": "2000",
"quantity_scale": 0,
"source": "response",
"unit": "credit",
"unit_quantity": "1"
}
],
"rounding": "ceil",
"variants": []
}
},
"examples": [
{
"http_status": 200,
"name": "Official example · Live API.SH response · Minimal request",
"request": {
"body": null,
"headers": {},
"path": {},
"query": {
"limit": "1",
"output": "json",
"raw": "0",
"type": "A388"
}
},
"response_body": {
"aircraft": [
{
"adsb_version": null,
"aircraft_type": "A388",
"altitude_baro_ft": 36000,
"altitude_geom_ft": null,
"callsign": "QFA12",
"category": null,
"emergency": null,
"ground_speed_kt": null,
"hex": "7c4922",
"indicated_airspeed_kt": null,
"interesting": false,
"latitude": -0.1667,
"longitude": -148.2667,
"mach": null,
"magnetic_heading_deg": null,
"messages": 0,
"military": false,
"nac_p": null,
"nac_v": null,
"nic": 0,
"on_ground": false,
"outside_air_temp_c": null,
"qnh_hpa": null,
"receivers": 1,
"registration": "VH-OQC",
"roll_deg": null,
"rssi": -20.5,
"sda": null,
"seconds_since_position": 1224.6,
"seconds_since_seen": 1224.6,
"selected_altitude_fms_ft": null,
"selected_altitude_ft": null,
"selected_heading_deg": null,
"sil": null,
"source": "adsc",
"squawk": null,
"total_air_temp_c": null,
"track_deg": 223.3,
"track_rate": null,
"true_airspeed_kt": null,
"true_heading_deg": null,
"vertical_rate_baro_fpm": null,
"vertical_rate_geom_fpm": null,
"wind_direction_deg": null,
"wind_speed_kt": null
}
],
"cached": false,
"count": 1,
"credits_used": 1,
"fetched_at": "2026-11-19T12:23:53.581Z",
"next_offset": 1,
"offset": 0,
"time": "2026-11-19T12:23:53.001Z",
"total": 59,
"type": "A388"
}
}
]
}
```Error handling
| Status | Next step |
|---|---|
400 | Check the offering and request fields. |
401 / 403 | Verify your credentials and access permissions. |
402 | Inspect the selected access mode and returned payment requirements. |
429 | Respect the returned rate limit and retry guidance. |
5xx | Inspect the error and usage record before retrying a paid operation. |
Official example · Live API.SH response · Minimal request
Example from the provider's documentation. Field values in your results will differ.
Prepare your environment
Use a terminal with cURL installed.
Use an OpenAny API key with shared-balance access. Confirm availability and price before running; a call may charge your balance.
Set the key in your terminal using the hidden prompt below. Keep its value out of source files and logs.
Terminal · macOS / Linuxprintf 'OpenAny API key: ' read -r -s OPENANY_API_KEY export OPENANY_API_KEY printf '\n'Run the request
Paste the complete command below into your terminal.
Values to replace before running 8
Review these request fields before running. Keep the published provider and request method unchanged.
type- ICAO type designator, e.g. `A388`, `B744`, `C17`.
limit- Aircraft per page (1-500, default 100).
offset- Skip this many aircraft.
raw- 0 leaves out the bulky `raw` source blocks (often 10-30x smaller).
fields- Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included.
fresh- 1 skips the 24-hour cache and fetches live.
output- JSON only for this OpenAny product. Omit output or use json; CSV and NDJSON are not supported.
records- With output=csv|ndjson: the top-level list to turn into rows (e.g. `reviews`), or `.` for the whole object as one row.
Terminal · cURLcurl \ 'https://api.openany.si/v1/agent-apis/apish/adsbexchange/v1/type?limit=1&output=json&raw=0&type=A388' \ -X GET \ -H "Authorization: Bearer $OPENANY_API_KEY" \ -H 'Content-Type: application/json'Check the response
Sample response · Documented HTTP 200
Sample response