RadarBox On Demand API (2.1.1)
Download OpenAPI specification:Download
AirNav RadarBox On Demand API enables you to quickly and easily integrate real-time, scheduled or historical flight data into your solutions. Available fields include flight number, scheduled, estimated and actual departure and arrival times, flight parameters such as speed and altitude, aircraft registration/tail-number.
A full list of available fields is listed on the response sections below.
For any questions, requests or suggestions contact our support.
For pricing details go to:
https://www.radarbox.com/api/pricingClick on the link below for details on flight data sources:
https://www.radarbox.com/flight-dataFor practical examples please check our blog post here:
https://www.radarbox.com/blog/on-demand-api-v2-examplesAlso you can download our client SDK to use our API in less than 5 minutes:
Note: for RadarBox old API documentation visit this page
Aircraft by id
Get aircraft details by id (Mode-S hex code or tail number
Authorizations:
query Parameters
| modeS | string Mode-S code | |
| registration | string Registration |
Responses
Response Schema: */*
| cost | integer <int32> (Cost of the operation (credits)) |
| success | boolean (Result of the operation) |
| comment | string (Additional info about the operation) |
| totaPages | integer <int32> (Total pages in the dataset) |
| totalRecords | integer <int32> (Total records in the dataset) |
| pageSize | integer <int32> (Page size) |
| currentPage | integer <int32> (Current page) |
object (Aircraft) |
Copied
get/aircraft
https://api.radarbox.com/v2/aircraft
Aircraft search
Search aircraft by ICAO Type or Airline
Authorizations:
query Parameters
| aircraftType | string ICAO aircraft type | |
| airline | string Airline (ICAO code) |
Responses
Response Schema: */*
| cost | integer <int32> (Cost of the operation (credits)) |
| success | boolean (Result of the operation) |
| comment | string (Additional info about the operation) |
| totaPages | integer <int32> (Total pages in the dataset) |
| totalRecords | integer <int32> (Total records in the dataset) |
| pageSize | integer <int32> (Page size) |
| currentPage | integer <int32> (Current page) |
Array of objects (Aircraft) |
Copied
get/aircraft/search
https://api.radarbox.com/v2/aircraft/search
Get live flights
Use this endpoint if your goal is to get real time information for live flights, either if you are looking for a specific geographical location or particular aircraft/airline/airport.
Authorizations:
header Parameters
| Authorization | string |
Request Body schema: application/json
| pageSize | integer <int32> (Page size) |
| page | integer <int32> (Page) |
| registrations | Array of strings (Filters the results by registration/tail-number) |
| airlines | Array of strings (Filter the results by the 3 letter ICAO code operator) |
| aircraftTypes | Array of strings (Filters the results by the 4 letter ICAO code aircraft type) |
| incLastKnownPos | boolean (Flag indicating whether archived flights should be returned as well) |
| minLatitude | number <double> (Minimum latitude for the bounding rectangle from which positions will be retrieved) |
| maxLatitude | number <double> (Maximum latitude for the bounding rectangle from which positions will be retrieved) |
| minLongitude | number <double> (Minimum longitude for the bounding rectangle from which positions will be retrieved) |
| maxLongitude | number <double> (Maximum longitude for the bounding rectangle from which positions will be retrieved) |
| fromAirports | Array of strings (Only show flights that departed from these airports (ICAO code)) |
| toAirports | Array of strings (Only show flights that are headed to these airports (ICAO code)) |
| toOrFromAirports | Array of strings (Only show flights that departed or are headed to these airports (ICAO code)) |
Responses
Response Schema: */*
| cost | integer <int32> (Cost of the operation (credits)) |
| success | boolean (Result of the operation) |
| comment | string (Additional info about the operation) |
Array of objects (List of flights) | |
| totaPages | integer <int32> (Total pages in the dataset) |
| totalRecords | integer <int32> (Total records in the dataset) |
| pageSize | integer <int32> (Page size) |
| currentPage | integer <int32> (Current page) |
Copied
post/flights/live
https://api.radarbox.com/v2/flights/live
Request samples
- Payload
Content type
application/json
{- "pageSize": 0,
- "page": 0,
- "registrations": [
- "G-YMML"
], - "airlines": [
- "BAW"
], - "aircraftTypes": [
- "B772"
], - "incLastKnownPos": true,
- "minLatitude": 0.431234,
- "maxLatitude": 51.509776,
- "minLongitude": -2.962865,
- "maxLongitude": -0.372603,
- "fromAirports": [
- "EGLL"
], - "toAirports": [
- "EGGL"
], - "toOrFromAirports": [
- "EGLL"
]
}Search flights by geographical area
Use this endpoint if you are interested in knowing which flights have flown over a particular geographical area at a given point in time
Authorizations:
query Parameters
| page | integer <int32> Request page | |
| pageSize | integer <int32> Page size |
header Parameters
| Authorization | string |
Request Body schema: application/json
| fromDate required | string <date-time> (Beginning of the search window in UTC (format: yyyy:MM:ddTHH:mm:ss.sssZ)) |
| maxLatitude required | number <double> (Maximum latitude for the bounding rectangle from which positions will be retrieved) |
| maxLongitude required | number <double> (Maximum longitude for the bounding rectangle from which positions will be retrieved) |
| minLatitude required | number <double> (Minimum latitude for the bounding rectangle from which positions will be retrieved) |
| minLongitude required | number <double> (Minimum longitude for the bounding rectangle from which positions will be retrieved) |
| toDate required | string <date-time> (End of the search window in UTC (format: yyyy:MM:ddTHH:mm:ss.sssZ)) |
| pageSize | integer <int32> (Page size) |
| page | integer <int32> (Page) |
| belowAltitude | integer <int32> (Only returns positions below this altitude - in feet) |
| aboveAltitude | integer <int32> (Only returns positions above this altitude - in feet) |
| includeFlightPaths | boolean (Include flight path positions in the results) |
| registrations | Array of strings (Filters the results by registration/tail-number) |
| modeSHexCodes | Array of strings (Mode-s Hex codes of the aircraft) |
| airlines | Array of strings (Filters response by 3 letters operator ICAO codes) unique |
| aircraftTypes | Array of strings (Filters the results by the 4 letter ICAO code aircraft types) unique |
| aircraftClasses | Array of strings unique |
Responses
Response Schema: */*
| cost | integer <int32> (Cost of the operation (credits)) |
| success | boolean (Result of the operation) |
| comment | string (Additional info about the operation) |
Array of objects (List of flights) | |
| totaPages | integer <int32> (Total pages in the dataset) |
| totalRecords | integer <int32> (Total records in the dataset) |
| pageSize | integer <int32> (Page size) |
| currentPage | integer <int32> (Current page) |
Copied
post/flights/geosearch
https://api.radarbox.com/v2/flights/geosearch
Request samples
- Payload
Content type
application/json
{- "pageSize": 0,
- "page": 0,
- "minLatitude": 51.431234,
- "maxLatitude": 51.509776,
- "minLongitude": -2.962865,
- "maxLongitude": -0.372603,
- "belowAltitude": 10000,
- "aboveAltitude": 20,
- "includeFlightPaths": true,
- "registrations": [
- "TC-JJU",
- "9V-SMN"
], - "modeSHexCodes": [
- "4BA955",
- "76CDAE"
], - "fromDate": "2020-04-20T10:25:00Z",
- "toDate": "2020-04-20T10:30:00Z",
- "airlines": [
- "SIA",
- "THY"
], - "aircraftTypes": [
- "B77W",
- "A359"
], - "aircraftClasses": [
- "string"
]
}Search flights
Use this endpoint for general flight searches - past, present or future (scheduled) - based on departure/arrival location or individual flights and tail numbers. The search always needs to be restricted by date (either departure, arrival or both).
Authorizations:
query Parameters
| page | integer <int32> Request page | |
| pageSize | integer <int32> Page size |
header Parameters
| Authorization | string |
Request Body schema: application/json
| pageSize | integer <int32> (Page size) |
| page | integer <int32> (Page) |
| fromDate | string <date-time> (Beginning of the search window in UTC (format: yyyy:MM:ddTHH:mm:ss.sssZ)) |
| toDate | string <date-time> (End of the search window in UTC (format: yyyy:MM:ddTHH:mm:ss.sssZ)) |
| departureFromDate | string <date-time> (Beginning of the departure date search window in UTC (format: yyyy:MM:ddTHH:mm:ss.sssZ)) |
| departureToDate | string <date-time> (End of the departure date search window in UTC (format: yyyy:MM:ddTHH:mm:ss.sssZ)) |
| arrivalFromDate | string <date-time> (Beginning of the arrival date search window in UTC (format: yyyy:MM:ddTHH:mm:ss.sssZ)) |
| arrivalToDate | string <date-time> (End of the arrival date search window in UTC (format: yyyy:MM:ddTHH:mm:ss.sssZ)) |
| registrations | Array of strings (Filters the results by registration/tail-number) |
| flightIds | Array of strings (List of flight numbers for the flight in ICAO or IATA format) |
| modeSHexCodes | Array of strings (Mode-s Hex codes of the aircraft) |
| airlines | Array of strings (Filter the results by the 3 letter ICAO code operator) |
| toAirports | Array of strings (Filters response for flights arriving to a specific airport ICAO codes) |
| fromAirports | Array of strings (Filters response for flights departing from a specific airport ICAO codes) |
| includeFlightPaths | boolean (Include flight path positions in the results) |
| sources | Array of strings (Only show data that come from these sources) Items Enum: "ADSB" "ASDI" "ASDEX" "OCEA" "MLAT" "HFDL" "SATE" |
| aircraftClasses | Array of strings (Filters response by aircraft class) |
Responses
Response Schema: */*
| cost | integer <int32> (Cost of the operation (credits)) |
| success | boolean (Result of the operation) |
| comment | string (Additional info about the operation) |
Array of objects (List of flights) | |
| totaPages | integer <int32> (Total pages in the dataset) |
| totalRecords | integer <int32> (Total records in the dataset) |
| pageSize | integer <int32> (Page size) |
| currentPage | integer <int32> (Current page) |
Copied
post/flights/search
https://api.radarbox.com/v2/flights/search
Request samples
- Payload
Content type
application/json
{- "pageSize": 0,
- "page": 0,
- "fromDate": "2020-01-06T00:00:00Z",
- "toDate": "2020-01-06T23:59:59Z",
- "departureFromDate": "2020-01-06T00:00:00Z",
- "departureToDate": "2020-01-06T23:59:59Z",
- "arrivalFromDate": "2020-01-06T00:00:00Z",
- "arrivalToDate": "2020-01-06T23:59:59Z",
- "registrations": [
- "PH-BHO",
- "G-YMML"
], - "flightIds": [
- "KL745",
- "BAW195"
], - "modeSHexCodes": [
- "485789",
- "4007F7"
], - "airlines": [
- "BAW",
- "KLM"
], - "toAirports": [
- "KIAH",
- "SKBO"
], - "fromAirports": [
- "EHAM",
- "EGLL"
], - "includeFlightPaths": false,
- "sources": [
- "ADSB",
- "MLAT",
- "ASDI"
], - "aircraftClasses": [
- "AIRLINE",
- "CARGO"
]
}Get NOTAMS by airport
Get airport NOTAMS by code
Authorizations:
path Parameters
| icaoCode required | string ICAO code |
Responses
Response Schema: */*
| cost | integer <int32> (Cost of the operation (credits)) |
| success | boolean (Result of the operation) |
| comment | string (Additional info about the operation) |
| totaPages | integer <int32> (Total pages in the dataset) |
| totalRecords | integer <int32> (Total records in the dataset) |
| pageSize | integer <int32> (Page size) |
| currentPage | integer <int32> (Current page) |
Array of objects (Airport NOTAMs) |
Copied
get/airports/{icaoCode}/notams
https://api.radarbox.com/v2/airports/{icaoCode}/notams
Get METAR by airport
Get airport Metar by code
Authorizations:
path Parameters
| icaoCode required | string ICAO code |
Responses
Response Schema: */*
| cost | integer <int32> (Cost of the operation (credits)) |
| success | boolean (Result of the operation) |
| comment | string (Additional info about the operation) |
| totaPages | integer <int32> (Total pages in the dataset) |
| totalRecords | integer <int32> (Total records in the dataset) |
| pageSize | integer <int32> (Page size) |
| currentPage | integer <int32> (Current page) |
object (METAR (METeorological Aerodrome Report)) METARs provide a report of the current weather conditions in the vicinity of an aerodrome |
Copied
get/airports/{icaoCode}/metar
https://api.radarbox.com/v2/airports/{icaoCode}/metar
Get TAF by airport
Get airport TAF by code
Authorizations:
path Parameters
| icaoCode required | string ICAO code |
Responses
Response Schema: */*
| cost | integer <int32> (Cost of the operation (credits)) |
| success | boolean (Result of the operation) |
| comment | string (Additional info about the operation) |
| totaPages | integer <int32> (Total pages in the dataset) |
| totalRecords | integer <int32> (Total records in the dataset) |
| pageSize | integer <int32> (Page size) |
| currentPage | integer <int32> (Current page) |
object (TAF (Terminal Aerodrome Forecast)) Weather forecast Information provided by airports to serve the surrounding air traffic. TAF reports are updated several times throughout the day to ensure that pilots have access to the most up-to-date information as possible |
Copied
get/airports/{icaoCode}/taf
https://api.radarbox.com/v2/airports/{icaoCode}/taf
Get D-ATIS by airport
Get airport D-ATIS by code
Authorizations:
path Parameters
| icaoCode required | string ICAO code |
Responses
Response Schema: */*
| cost | integer <int32> (Cost of the operation (credits)) |
| success | boolean (Result of the operation) |
| comment | string (Additional info about the operation) |
| totaPages | integer <int32> (Total pages in the dataset) |
| totalRecords | integer <int32> (Total records in the dataset) |
| pageSize | integer <int32> (Page size) |
| currentPage | integer <int32> (Current page) |
object (D-ATIS (Data link - Automatic Terminal Information Service)) ATIS is a service that continuously broadcasts aeronautical information around the airport. D-ATIS is the text transcription of the information provided by it. |
Copied
get/airports/{icaoCode}/datis
https://api.radarbox.com/v2/airports/{icaoCode}/datis
Airport search
Search airports per country, city or coordinates
Authorizations:
query Parameters
| countryCode | string Country code (2 letters) | |
| countryName | string Country name | |
| icaoCode | string Airport ICAO code | |
| onlyMajor | boolean Only major airports | |
| city | string City | |
| latitude1 | number <double> Latitude 1 | |
| longitude1 | number <double> Longitude 1 | |
| latitude2 | number <double> Latitude 2 | |
| longitude2 | number <double> Longitude 2 |
Responses
Response Schema: */*
| cost | integer <int32> (Cost of the operation (credits)) |
| success | boolean (Result of the operation) |
| comment | string (Additional info about the operation) |
| totaPages | integer <int32> (Total pages in the dataset) |
| totalRecords | integer <int32> (Total records in the dataset) |
| pageSize | integer <int32> (Page size) |
| currentPage | integer <int32> (Current page) |
Array of objects (List of flights) |
Copied
get/airports/search
https://api.radarbox.com/v2/airports/search
Airport by code
Get airport details by code
Authorizations:
path Parameters
| icaoCode required | string ICAO code |
Responses
Response Schema: */*
| cost | integer <int32> (Cost of the operation (credits)) |
| success | boolean (Result of the operation) |
| comment | string (Additional info about the operation) |
| totaPages | integer <int32> (Total pages in the dataset) |
| totalRecords | integer <int32> (Total records in the dataset) |
| pageSize | integer <int32> (Page size) |
| currentPage | integer <int32> (Current page) |
object (Flight) |
Copied
get/airports/{icaoCode}
https://api.radarbox.com/v2/airports/{icaoCode}