Skip to content
Scrappa Get API key
RadarBox API 3 credits / request

RadarBox Flight History API Documentation

GET https://scrappa.co/api/radarbox/flight-history

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.

RadarBox Flight History API Documentation 3 credits / request

Endpoint

Request preview
GET
https://scrappa.co/api/radarbox/flight-history
Auth header
x-api-key
Cost
3 credits / request
Response preview
200 OK
{
    "data": {
        "count": 1,
        "query": {
            "id": "LH400",
            "date": null,
            "page": 1,
            "lookup": "flight_number"
        },
        "flights": [
            {
                "fid": 3017263384,
                "date": "2026-11-13",
                "status": "landed",
...

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.

flight_number string Optional

Flight number, e.g. LH400 or DLH400. Send exactly one of the six lookups.

Example value example
registration string Optional

Aircraft registration, e.g. D-AIXD.

Example value example
callsign string Optional

Callsign, e.g. DLH400.

Example value example
mode_s string Optional

Mode-S hex code of the aircraft, e.g. 3c6704.

Example value example
airline string Optional

Airline IATA or ICAO code, e.g. LH or DLH. 30 legs per page.

Example value example
aircraft_type string Optional

Aircraft ICAO type, e.g. A359. 30 legs per page.

Example value example
date string Optional

One UTC departure day, YYYY-MM-DD, inside the 7 day window. Only legs of that day are returned.

Example value 2026-06-15
page integer Optional

Result page, 1 to 50.

Example value 1

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "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.

422

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"
}
404

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
}
503

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.