Skip to main content
POST
/
api
/
opensky
/
states
/opensky/states
curl --request POST \
  --url https://api.anysite.io/api/opensky/states \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "icao24": [
    "<string>"
  ],
  "timeout": 300,
  "extended": false
}
'
[
  {
    "icao24": "<string>",
    "@type": "@opensky_state",
    "callsign": "<string>",
    "origin_country": "<string>",
    "time_position": 123,
    "last_contact": 123,
    "longitude": 123,
    "latitude": 123,
    "baro_altitude": 123,
    "on_ground": true,
    "velocity": 123,
    "true_track": 123,
    "vertical_rate": 123,
    "geo_altitude": 123,
    "squawk": "<string>",
    "spi": true
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
icao24
string[]
required

One or more aircraft ICAO 24-bit transponder addresses (lowercase hex)

Minimum array length: 1
Examples:
["3c6444"]
["3c6444", "4b1814"]
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
extended
boolean
default:false

Include the aircraft category for each state vector

Response

Successful Response

​
icao24
string
required
​
@type
string
default:@opensky_state
​
callsign
string | null
​
origin_country
string | null
​
time_position
integer | null
​
last_contact
integer | null
​
longitude
number | null
​
latitude
number | null
​
baro_altitude
number | null
​
on_ground
boolean | null
​
velocity
number | null
​
true_track
number | null
​
vertical_rate
number | null
​
geo_altitude
number | null
​
squawk
string | null
​
spi
boolean | null
​
position_source
enum<integer> | null
Available options:
0,
1,
2,
3
​
category
enum<integer> | null
Available options:
0,
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20