# RadarBox Flight History API Documentation

<p><strong>RadarBox Flight History API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/radarbox-api/radarbox_flight_history](https://scrappa.co/docs/radarbox-api/radarbox_flight_history)
- **API group:** RadarBox API
- **Endpoint:** `GET https://scrappa.co/api/radarbox/flight-history`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `flight_number` | string | No | Flight number, e.g. LH400 or DLH400. Send exactly one of the six lookups. |
| `registration` | string | No | Aircraft registration, e.g. D-AIXD. |
| `callsign` | string | No | Callsign, e.g. DLH400. |
| `mode_s` | string | No | Mode-S hex code of the aircraft, e.g. 3c6704. |
| `airline` | string | No | Airline IATA or ICAO code, e.g. LH or DLH. 30 legs per page. |
| `aircraft_type` | string | No | Aircraft ICAO type, e.g. A359. 30 legs per page. |
| `date` | string | No | One UTC departure day, YYYY-MM-DD, inside the 7 day window. Only legs of that day are returned. |
| `page` | integer | No | Result page, 1 to 50. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | RadarBox has no data for this airport or flight. This response is not billable. |
| 503 | Service Unavailable | RadarBox could not be reached or changed its answer. This response is not billable. Retry later. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
