RadarBox Flight History API Documentation Legs of one flight number, registration, callsign, mode-s code, airline or aircraft type from AirNav RadarBox. Send exactly one lookup. Every leg has its fid, flight numbers (IATA and ICAO), callsign, codeshares, status, aircraft with registration and type, airline, airports with city, position and time zone, scheduled, estimated and actual times in UTC, the local date and local scheduled time, gates, terminals, delay minutes, distance and duration. Lists reach 7 days back and 2 days ahead. A date outside that window answers an empty list. Keep the fid of a leg: a leg of any age is readable by its fid with /api/radarbox/flight. An empty answer is free. Cost: 3 credits for each page with legs. RadarBox shows 7 days back and 2 days ahead without a login. A date outside this window answers 200 with an empty list, depth_limit_days 7 and a note, and costs nothing. An older leg is reachable only by its fid (measured back to 2020-12-02). For flight number and date lookups far back, use /api/flightera/flight.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
8 optional filters available.
string
Optional
Flight number, e.g. LH400 or DLH400. Send exactly one of the six lookups.
example
string
Optional
Aircraft registration, e.g. D-AIXD.
example
string
Optional
Callsign, e.g. DLH400.
example
string
Optional
Mode-S hex code of the aircraft, e.g. 3c6704.
example
string
Optional
Airline IATA or ICAO code, e.g. LH or DLH. 30 legs per page.
example
string
Optional
Aircraft ICAO type, e.g. A359. 30 legs per page.
example
string
Optional
One UTC departure day, YYYY-MM-DD, inside the 7 day window. Only legs of that day are returned.
2026-06-15
integer
Optional
Result page, 1 to 50.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"count": 1,
"query": {
"id": "LH400",
"date": null,
"page": 1,
"lookup": "flight_number"
},
"flights": [
{
"fid": 3017263384,
"date": "2026-11-13",
"status": "landed",
"airline": {
"iata": "LH",
"icao": "DLH",
"name": "Lufthansa",
"operating_iata": "LH",
"operating_icao": "DLH",
"operating_name": "Lufthansa"
},
"arrival": {
"gate": "5",
"actual": "2026-11-14T01:05:00Z",
"airport": {
"city": "New York, NY",
"iata": "JFK",
"icao": "KJFK",
"name": "New York - John F Kennedy International Airport",
"state": "New York",
"country": "United States",
"latitude": 40.6398,
"longitude": -73.7789,
"timezone_name": "Eastern Standard Time",
"timezone_abbreviation": "EST",
"timezone_offset_hours": -5
},
"terminal": "1",
"estimated": "2026-11-14T00:29:00Z",
"scheduled": "2026-11-13T18:35:00Z",
"local_date": "2026-11-13",
"baggage_belt": null,
"scheduled_local": "2026-11-13T13:35:00-05:00"
},
"aircraft": {
"mode_s": "3C6704",
"country": "DE",
"type_icao": "A359",
"type_name": "Airbus A350-941",
"registration": "D-AIXD"
},
"callsign": "DLH400",
"departure": {
"gate": "Z66",
"actual": "2026-11-13T16:37:00Z",
"airport": {
"city": "Frankfurt",
"iata": "FRA",
"icao": "EDDF",
"name": "Frankfurt am Main International Airport",
"state": "Hesse",
"country": "Germany",
"latitude": 50.0264,
"longitude": 8.54313,
"timezone_name": "Central European Standard Time",
"timezone_abbreviation": "CET",
"timezone_offset_hours": 1
},
"terminal": "1",
"estimated": "2026-11-13T16:50:00Z",
"scheduled": "2026-11-13T15:00:00Z",
"local_date": "2026-11-13",
"baggage_belt": null,
"scheduled_local": "2026-11-13T16:00:00+01:00"
},
"alias_fids": [
3014506324
],
"codeshares": [
"UA8841",
"SN7230",
"ET1610",
"NZ4226",
"TG7722"
],
"distance_km": 6189.7,
"duration_type": "actual",
"flight_number": "LH400",
"duration_minutes": 453,
"progress_percent": 100,
"flight_number_icao": "DLH400",
"delay_arrival_minutes": 390,
"delay_departure_minutes": 97
}
]
},
"meta": {
"page": 1,
"credits": 3,
"billable": true,
"has_more": false,
"depth_note": "RadarBox lists show 7 days back and 2 days ahead without a login. An older leg is reachable only by its fid (measured back to 2020-12-02). For flight number and date lookups far back, use /api/flightera/flight.",
"endpoint_family": "flight_history",
"dropped_mismatch": 0,
"window_days_back": 7,
"window_days_forward": 2
},
"success": true
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. This response is not billable.
{
"errors": {
"flight_number": [
"The flight number field is required."
]
},
"message": "The request validation failed"
}Not Found
RadarBox has no data for this airport or flight. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "flight_history"
},
"error": {
"code": "NOT_FOUND",
"message": "RadarBox has no data for this airport or flight."
},
"success": false
}Service Unavailable
RadarBox could not be reached or changed its answer. This response is not billable. Retry later.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "flight_history"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The RadarBox source is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.