This API is still in very early stage and not following versioning. Expect breaking changes at any time, including but not limited to endpoint removal/rename and rate limit changes!
This API is free for non-commercial use under our terms of service.
All implementations
must use a custom user agent, this being
RP-[YourUserId]
. Sending an incorrect user ID will result in a 403 indicating the UserAgent you must set.
Authentication is done via the Authorization header with the API Key obtained on the My Account page.
Some of the endpoints that require authentication also need a specific role. Your roles are available on the My Account page.
At this time, the following roles are available:
Endpoints are split into tiers, from 1-3, with 1 being the most restricted.
The higher the tier, the more strict the rate limiting.
Rate limits are enforced using the time window algorithm for all endpoints within the same tier, based on a 24-hour window.
Rate Limit (Auth): 200 requests/day
Rate Limit (Guest): 100 requests/day
Rate Limit (Roles):
Gets all military aircraft currently tracked by the network
Method: GET
Auth Required: Yes
{}
{
"success": true,
"data": [
{
"position_at": "2023-07-19 16:12:28",
"latitude": "26.29129",
"longitude": "-111.28404",
"track": "191.0",
"vertical_rate": -2147483648,
"squawk": "1270",
"on_ground": false,
"callsign": "null",
"altitude_ft": 13550,
"speed": "170.00000",
"icao": "0D0E6B",
"registration": "ANX-1261",
"model_icao": "C208",
"is_military": true,
"position_rank": 1
},
{
"position_at": "2023-07-19 16:12:37",
"latitude": "39.20304",
"longitude": "12.64056",
"track": "9.5",
"vertical_rate": -64,
"squawk": "5146",
"on_ground": false,
"callsign": "POLI114",
"altitude_ft": 11000,
"speed": "127.70000",
"icao": "320015",
"registration": "MM81838",
"model_icao": "A139",
"is_military": true,
"position_rank": 1
}
]
}
Get last airport departures
Method: GET
Auth Required: No
{}
{
"success": true,
"data": {
"departures": [
{
"id": 270786,
"aircraft": {
"icao": "49514B",
"registration": "CS-TJK",
"model_icao": "A21N"
},
"landing_airport": null,
"departure_time": "2023-07-19 20:00:36",
"landing_time": null,
"flight_number": "TAP1862"
},
{
"id": 268308,
"aircraft": {
"icao": "495246",
"registration": "CS-TRF",
"model_icao": "DH8D"
},
"landing_airport": {
"icao": "LPLA",
"name": "Lajes Airport"
},
"departure_time": "2023-07-19 19:26:03",
"landing_time": "2023-07-19 19:52:12",
"flight_number": "SAT1400"
},
{
"id": 267457,
"aircraft": {
"icao": "495266",
"registration": "CS-TSF",
"model_icao": "A21N"
},
"landing_airport": null,
"departure_time": "2023-07-19 19:13:21",
"landing_time": null,
"flight_number": "null"
},
{
"id": 266376,
"aircraft": {
"icao": "495247",
"registration": "CS-TRG",
"model_icao": "DH8D"
},
"landing_airport": null,
"departure_time": "2023-07-19 18:57:49",
"landing_time": null,
"flight_number": "SAT7438"
},
{
"id": 265770,
"aircraft": {
"icao": "49514D",
"registration": "CS-TJM",
"model_icao": "A21N"
},
"landing_airport": null,
"departure_time": "2023-07-19 18:49:31",
"landing_time": null,
"flight_number": "RZO124"
},
{
"id": 262188,
"aircraft": {
"icao": "4CACE0",
"registration": "EI-GJT",
"model_icao": "B738"
},
"landing_airport": {
"icao": "LPPT",
"name": "Humberto Delgado Airport (Lisbon Portela Airport)"
},
"departure_time": "2023-07-19 18:03:43",
"landing_time": "2023-07-19 19:50:09",
"flight_number": "RYR6KK"
},
{
"id": 260384,
"aircraft": {
"icao": "495268",
"registration": "CS-TSH",
"model_icao": "A21N"
},
"landing_airport": null,
"departure_time": "2023-07-19 17:39:32",
"landing_time": null,
"flight_number": "RZO323"
},
{
"id": 252687,
"aircraft": {
"icao": "485A84",
"registration": "PH-TFR",
"model_icao": "B38M"
},
"landing_airport": {
"icao": "EHAM",
"name": "Amsterdam Airport Schiphol"
},
"departure_time": "2023-07-19 16:04:07",
"landing_time": "2023-07-19 20:03:45",
"flight_number": "TFL731"
},
{
"id": 252477,
"aircraft": {
"icao": "495244",
"registration": "CS-TRD",
"model_icao": "DH8D"
},
"landing_airport": {
"icao": "LPLA",
"name": "Lajes Airport"
},
"departure_time": "2023-07-19 16:01:40",
"landing_time": "2023-07-19 17:38:42",
"flight_number": "SAT635"
},
{
"id": 243630,
"aircraft": {
"icao": "4CAFC0",
"registration": "EI-GSK",
"model_icao": "B738"
},
"landing_airport": {
"icao": "LPPR",
"name": "Francisco de Sá Carneiro Airport"
},
"departure_time": "2023-07-19 14:11:17",
"landing_time": "2023-07-19 16:08:44",
"flight_number": "RYR660K"
},
{
"id": 238865,
"aircraft": {
"icao": "495246",
"registration": "CS-TRF",
"model_icao": "DH8D"
},
"landing_airport": {
"icao": "LPFL",
"name": "Flores Airport"
},
"departure_time": "2023-07-19 13:12:10",
"landing_time": "2023-07-19 14:18:52",
"flight_number": "null"
},
{
"id": 236173,
"aircraft": {
"icao": "495244",
"registration": "CS-TRD",
"model_icao": "DH8D"
},
"landing_airport": null,
"departure_time": "2023-07-19 12:35:09",
"landing_time": null,
"flight_number": "SAT442"
},
{
"id": 232190,
"aircraft": {
"icao": "49514F",
"registration": "CS-TJO",
"model_icao": "A21N"
},
"landing_airport": {
"icao": "LPPT",
"name": "Humberto Delgado Airport (Lisbon Portela Airport)"
},
"departure_time": "2023-07-19 11:33:29",
"landing_time": "2023-07-19 13:24:40",
"flight_number": "TAP60KM"
},
{
"id": 230778,
"aircraft": {
"icao": "495242",
"registration": "CS-TRB",
"model_icao": "DH8B"
},
"landing_airport": null,
"departure_time": "2023-07-19 11:10:21",
"landing_time": null,
"flight_number": "null"
},
{
"id": 225064,
"aircraft": {
"icao": "495268",
"registration": "CS-TSH",
"model_icao": "A21N"
},
"landing_airport": {
"icao": "LPPT",
"name": "Humberto Delgado Airport (Lisbon Portela Airport)"
},
"departure_time": "2023-07-19 09:00:46",
"landing_time": "2023-07-19 10:52:05",
"flight_number": "RZO122"
},
{
"id": 224056,
"aircraft": {
"icao": "495266",
"registration": "CS-TSF",
"model_icao": "A21N"
},
"landing_airport": null,
"departure_time": "2023-07-19 08:33:41",
"landing_time": null,
"flight_number": "null"
},
{
"id": 222473,
"aircraft": {
"icao": "495246",
"registration": "CS-TRF",
"model_icao": "DH8D"
},
"landing_airport": null,
"departure_time": "2023-07-19 07:52:46",
"landing_time": null,
"flight_number": "SAT420"
},
{
"id": 222062,
"aircraft": {
"icao": "4CAFC0",
"registration": "EI-GSK",
"model_icao": "B738"
},
"landing_airport": {
"icao": "LPPT",
"name": "Humberto Delgado Airport (Lisbon Portela Airport)"
},
"departure_time": "2023-07-19 07:41:42",
"landing_time": "2023-07-19 09:31:22",
"flight_number": "RYR68GH"
},
{
"id": 221764,
"aircraft": {
"icao": "495242",
"registration": "CS-TRB",
"model_icao": "DH8B"
},
"landing_airport": {
"icao": "LPLA",
"name": "Lajes Airport"
},
"departure_time": "2023-07-19 07:33:04",
"landing_time": "2023-07-19 08:05:11",
"flight_number": "SAT400"
},
{
"id": 221627,
"aircraft": {
"icao": "495244",
"registration": "CS-TRD",
"model_icao": "DH8D"
},
"landing_airport": {
"icao": "LPLA",
"name": "Lajes Airport"
},
"departure_time": "2023-07-19 07:29:17",
"landing_time": "2023-07-19 09:11:32",
"flight_number": "SAT631"
}
]
}
}
Get last airport landings
Method: GET
Auth Required: No
{}
{
"success": true,
"data": {
"landings": [
{
"id": 256998,
"aircraft": {
"icao": "4CAFC0",
"registration": "EI-GSK",
"model_icao": "B738"
},
"departure_airport": {
"icao": "LPPR",
"name": "Francisco de Sá Carneiro Airport"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-19 16:57:15",
"landing_time": "2023-07-19 19:11:52",
"flight_number": "RYR2633"
},
{
"id": 256943,
"aircraft": {
"icao": "49514B",
"registration": "CS-TJK",
"model_icao": "A21N"
},
"departure_airport": {
"icao": "LPPT",
"name": "Humberto Delgado Airport (Lisbon Portela Airport)"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-19 16:56:32",
"landing_time": "2023-07-19 19:04:02",
"flight_number": "TAP1863"
},
{
"id": 259246,
"aircraft": {
"icao": "495246",
"registration": "CS-TRF",
"model_icao": "DH8D"
},
"departure_airport": {
"icao": "LPFL",
"name": "Flores Airport"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-19 17:25:53",
"landing_time": "2023-07-19 18:21:48",
"flight_number": "SAT503"
},
{
"id": 259219,
"aircraft": {
"icao": "495247",
"registration": "CS-TRG",
"model_icao": "DH8D"
},
"departure_airport": {
"icao": "LPLA",
"name": "Lajes Airport"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-19 17:25:31",
"landing_time": "2023-07-19 17:50:18",
"flight_number": "null"
},
{
"id": 247693,
"aircraft": {
"icao": "495242",
"registration": "CS-TRB",
"model_icao": "DH8B"
},
"departure_airport": {
"icao": "LPCR",
"name": "Corvo Airport"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-19 15:03:52",
"landing_time": "2023-07-19 17:00:08",
"flight_number": "null"
},
{
"id": 246032,
"aircraft": {
"icao": "4CACE0",
"registration": "EI-GJT",
"model_icao": "B738"
},
"departure_airport": {
"icao": "LPPT",
"name": "Humberto Delgado Airport (Lisbon Portela Airport)"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-19 14:41:45",
"landing_time": "2023-07-19 16:53:05",
"flight_number": "RYR2625"
},
{
"id": 244019,
"aircraft": {
"icao": "49514D",
"registration": "CS-TJM",
"model_icao": "A21N"
},
"departure_airport": {
"icao": "LPPT",
"name": "Humberto Delgado Airport (Lisbon Portela Airport)"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-19 14:16:06",
"landing_time": "2023-07-19 16:33:28",
"flight_number": "null"
},
{
"id": 238595,
"aircraft": {
"icao": "495268",
"registration": "CS-TSH",
"model_icao": "A21N"
},
"departure_airport": {
"icao": "LPPT",
"name": "Humberto Delgado Airport (Lisbon Portela Airport)"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-19 13:08:39",
"landing_time": "2023-07-19 15:19:18",
"flight_number": "null"
},
{
"id": 245325,
"aircraft": {
"icao": "485A84",
"registration": "PH-TFR",
"model_icao": "B38M"
},
"departure_airport": {
"icao": "LPLA",
"name": "Lajes Airport"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-19 14:32:48",
"landing_time": "2023-07-19 14:54:07",
"flight_number": "null"
},
{
"id": 229900,
"aircraft": {
"icao": "4CAFC0",
"registration": "EI-GSK",
"model_icao": "B738"
},
"departure_airport": {
"icao": "LPPT",
"name": "Humberto Delgado Airport (Lisbon Portela Airport)"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-19 10:53:23",
"landing_time": "2023-07-19 13:03:56",
"flight_number": "null"
},
{
"id": 227399,
"aircraft": {
"icao": "495244",
"registration": "CS-TRD",
"model_icao": "DH8D"
},
"departure_airport": {
"icao": "LPLA",
"name": "Lajes Airport"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-19 10:01:59",
"landing_time": "2023-07-19 11:31:10",
"flight_number": "null"
},
{
"id": 223753,
"aircraft": {
"icao": "49514F",
"registration": "CS-TJO",
"model_icao": "A21N"
},
"departure_airport": {
"icao": "LPPT",
"name": "Humberto Delgado Airport (Lisbon Portela Airport)"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-19 08:25:34",
"landing_time": "2023-07-19 10:35:47",
"flight_number": "TAP69MT"
},
{
"id": 224597,
"aircraft": {
"icao": "495242",
"registration": "CS-TRB",
"model_icao": "DH8B"
},
"departure_airport": {
"icao": "LPLA",
"name": "Lajes Airport"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-19 08:48:44",
"landing_time": "2023-07-19 09:16:29",
"flight_number": "null"
},
{
"id": 215274,
"aircraft": {
"icao": "495246",
"registration": "CS-TRF",
"model_icao": "DH8D"
},
"departure_airport": {
"icao": "LPMA",
"name": "Madeira International Airport Cristiano Ronaldo"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-19 04:45:36",
"landing_time": "2023-07-19 06:37:25",
"flight_number": "null"
},
{
"id": 206418,
"aircraft": {
"icao": "495268",
"registration": "CS-TSH",
"model_icao": "A21N"
},
"departure_airport": {
"icao": "KJFK",
"name": "John F Kennedy International Airport"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-19 01:21:56",
"landing_time": "2023-07-19 06:25:32",
"flight_number": "RZO246"
},
{
"id": 207299,
"aircraft": {
"icao": "495266",
"registration": "CS-TSF",
"model_icao": "A21N"
},
"departure_airport": {
"icao": "LYTV",
"name": "Tivat Airport"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-19 01:40:11",
"landing_time": "2023-07-19 06:15:39",
"flight_number": "null"
},
{
"id": 193644,
"aircraft": {
"icao": "495151",
"registration": "CS-TJQ",
"model_icao": "A21N"
},
"departure_airport": {
"icao": "LPPT",
"name": "Humberto Delgado Airport (Lisbon Portela Airport)"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-18 21:39:04",
"landing_time": "2023-07-18 23:43:40",
"flight_number": "TAP1865"
},
{
"id": 178420,
"aircraft": {
"icao": "4CAFC0",
"registration": "EI-GSK",
"model_icao": "B738"
},
"departure_airport": {
"icao": "LPPR",
"name": "Francisco de Sá Carneiro Airport"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-18 17:37:52",
"landing_time": "2023-07-18 19:53:14",
"flight_number": "null"
},
{
"id": 182101,
"aircraft": {
"icao": "495246",
"registration": "CS-TRF",
"model_icao": "DH8D"
},
"departure_airport": {
"icao": "LPLA",
"name": "Lajes Airport"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-18 18:27:02",
"landing_time": "2023-07-18 19:50:43",
"flight_number": "null"
},
{
"id": 180006,
"aircraft": {
"icao": "495245",
"registration": "CS-TRE",
"model_icao": "DH8D"
},
"departure_airport": {
"icao": "LPLA",
"name": "Lajes Airport"
},
"landing_airport": {
"icao": "LPPD",
"name": "João Paulo II Airport"
},
"departure_time": "2023-07-18 17:58:41",
"landing_time": "2023-07-18 19:36:01",
"flight_number": "SAT445"
}
]
}
}
Get details of a specific flight
Method: GET
Auth Required: No
{}
{
"success": true,
"data": {
"id": 625807,
"aircraft": "A4C735",
"departure": {
"id": 36751,
"icao": "KLAX",
"time": "2023-07-24 21:03:21"
},
"landing": {
"id": 35210,
"icao": "KBUR",
"time": "2023-07-24 21:16:12"
},
"processed": true,
"stored": true,
"acessible": true,
"ready": true
}
}
Get a GEOJSON track of a specific flight
Method: GET
Auth Required: No
{}
{
"success": true,
"data": {
"source": "bunker",
"distance": 472.9580187488187,
"data": {
"type": "Feature",
"geometry": {
"type": "LineString",
"coordinates": [...]
},
"properties": [...]
}
}
}
Get live information for multiple aircraft by ICAO, separated by comma (Limit = 10)
Method: GET
Auth Required: No
{}
{
"success": true,
"data": {
"planes": [
{
"position_at": "2023-08-08 15:55:55",
"latitude": "37.47478",
"longitude": "-24.29310",
"squawk": null,
"on_ground": false,
"callsign": "AEA055",
"altitude_ft": 38975,
"speed": "484.30000",
"icao": "34529A",
"emergency": false
},
{
"position_at": "2023-08-08 15:54:54",
"latitude": "38.56927",
"longitude": "-29.23346",
"squawk": "5134",
"on_ground": false,
"callsign": "null",
"altitude_ft": 8150,
"speed": "270.00000",
"icao": "495243",
"emergency": false
}
]
}
}
Rate Limit (Auth): 1000 requests/day
Rate Limit (Guest): 300 requests/day
Get route information for a callsign
Method: GET
Auth Required: No
{}
{
"success": true,
"data": {
"id": 712108,
"callsign": "SAT614",
"airports": [
{
"id": 41194,
"icao": "LPLA",
"name": "Lajes Airport",
"route_sequence": 0
},
{
"id": 41186,
"icao": "LPSJ",
"name": "São Jorge Airport",
"route_sequence": 1
}
]
}
}
Get the live position of an aircraft by ICAO
Method: GET
Auth Required: No
{}
{
"success": true,
"data": {
"planes": [
{
"position_at": "2023-08-08 15:51:50",
"latitude": "37.75414",
"longitude": "-23.56842",
"squawk": "6060",
"on_ground": false,
"callsign": "AEA055",
"altitude_ft": 39000,
"speed": "480.00000",
"icao": "34529A",
"emergency": false
}
]
}
}
Rate Limit (Auth): 7000 requests/day
Rate Limit (Guest): 5000 requests/day
Get aircraft information for an ICAO hex code
Method: GET
Auth Required: No
{}
{
"success": true,
"data": {
"id": 834243,
"icao": "495265",
"is_military": false,
"registration": "CS-TSE",
"country": null,
"manufacturer": null,
"model": "Bombardier DHC-8 402 NG",
"model_icao": "DH8D",
"operator": null,
"operator_icao": null,
"serial": null,
"year_build": null,
"picture_url": "https://t.plnspttrs.net/25178/1297189_7f6231ab45_280.jpg"
}
}
List active TFRs
Method: GET
Auth Required: No
{}
{
"success": true,
"data": [
{
"Date": "07/19/2023",
"NOTAM": "3/9053",
"Facility": "ZMP",
"State": "MN",
"Type": "HAZARDS",
"Description": "HIBBING, MN, Wednesday, July 19, 2023 UTC New",
"Zoom": null,
"details": {
"txtLocalName": "3/9053",
"dateEffective": "2023-07-19T16:30:00",
"dateExpire": "2023-07-19T18:00:00",
"codeTimeZone": "UTC",
"codeExpirationTimeZone": "UTC",
"shapes": [
{
"type": "circle",
"radius": "2.0",
"lat": 47.46527778,
"lon": -92.90777778,
"txtName": "Hazard Area1",
"valDistVerUpper": "4500",
"valDistVerLower": "0",
"uomDistVerUpper": "FT",
"uomDistVerLower": "FT",
"codeExclVerUpper": "INCLUDE",
"codeExclVerLower": "INCLUDE",
"isScheduledTfrArea": "FALSE"
}
]
},
"id": 1
},
{
"Date": "07/19/2023",
"NOTAM": "3/8891",
"Facility": "FDC",
"State": "GU",
"Type": "SECURITY",
"Description": "WAKE ISLAND, GU, Sunday, July 23, 2023 through Monday, July 24, 2023 UTC New",
"Zoom": null,
"details": {
"txtLocalName": "3/8891",
"dateEffective": "2023-07-23T20:00:00",
"dateExpire": "2023-07-24T00:01:00",
"codeTimeZone": "UTC",
"codeExpirationTimeZone": "UTC",
"shapes": []
},
"id": 2
}
]
}
Get airport information for an ICAO code
Method: GET
Auth Required: No
{}
{
"success": true,
"data": {
"id": 41205,
"ident": "LPPD",
"type": "large_airport",
"name": "João Paulo II Airport",
"latitude": "37.74120",
"longitude": "-25.69790",
"elevation_ft": 259,
"icao": "LPPD",
"iata": "PDL"
}
}
Get airport METAR information
Method: GET
Auth Required: No
{}
{
"success": true,
"data": {
"metar": {
"station": "LPPD",
"valid": "2023-07-19 19:30",
"lon": "-25.6979",
"lat": "37.7412",
"elevation": "72.00",
"tmpf": "71.60",
"dwpf": "66.20",
"relh": "83.09",
"drct": "230.00",
"sknt": "4.00",
"p01i": "0.00",
"alti": "30.27",
"mslp": "null",
"vsby": "6.21",
"gust": "null",
"skyc1": "FEW",
"skyc2": "null",
"skyc3": "null",
"skyc4": "null",
"skyl1": "2000.00",
"skyl2": "null",
"skyl3": "null",
"skyl4": "null",
"wxcodes": "null",
"ice_accretion_1hr": "null",
"ice_accretion_3hr": "null",
"ice_accretion_6hr": "null",
"peak_wind_gust": "null",
"peak_wind_drct": "null",
"peak_wind_time": "null",
"feel": "71.60",
"metar": "LPPD 191930Z 23004KT 200V280 9999 FEW020 22/19 Q1025",
"snowdepth": "null"
}
}
}