# Flightera Flight History API Documentation

<p><strong>Flightera Flight History API Documentation</strong> Past flights of a flight number back to September 2017. Ask for one UTC departure day with date, a range with from and to (at most 190 days), or one month with month and page. Without a time the current month is returned. Every flight has scheduled, estimated and actual times in UTC and local time, the local date, delay minutes (actual minus scheduled, negative means early), gates, terminals, aircraft with registration, airline, airports with position and distance. The answer also has the number of flights per month and the on-time share of the last 30 days. Flights are listed newest first, 20 per page. An empty answer is free. Cost: 1 credit for each page read.</p>

- **Documentation:** [https://scrappa.co/docs/flightera-api/flightera_flight_history](https://scrappa.co/docs/flightera-api/flightera_flight_history)
- **API group:** Flightera API
- **Endpoint:** `GET https://scrappa.co/api/flightera/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 | Yes | Flight number, e.g. LH400 or BA117. A codeshare number follows the operating flight. |
| `date` | string | No | One UTC departure day, YYYY-MM-DD. Flights are listed from 2017-09-01. |
| `from` | string | No | First day of a range, YYYY-MM-DD. The range is at most 190 days. |
| `to` | string | No | Last day of a range, YYYY-MM-DD. Defaults to today. Needs from. |
| `month` | string | No | One month, YYYY-MM. Returns 20 flights per page. |
| `page` | integer | No | Page of a month, 1 to 5. Use next_page of the answer. |

## Example response

```json
{
    "data": {
        "count": 1,
        "window": {
            "to": "2025-10-31",
            "from": "2025-10-31"
        },
        "flights": [
            {
                "date": "2025-10-31",
                "status": "landed",
                "airline": {
                    "iata": "LH",
                    "icao": "DLH",
                    "name": "Lufthansa",
                    "country": "Germany"
                },
                "arrival": {
                    "gate": "8",
                    "airport": {
                        "city": "New York",
                        "iata": "JFK",
                        "icao": "KJFK",
                        "name": "John F. Kennedy International Airport",
                        "country": "United States",
                        "latitude": 40.63972,
                        "timezone": "America/New_York",
                        "longitude": -73.77889,
                        "country_code": "US"
                    },
                    "terminal": "1",
                    "actual_utc": "2025-10-31T18:53:23Z",
                    "local_date": "2025-10-31",
                    "actual_local": "2025-10-31T14:53:23-04:00",
                    "estimated_utc": null,
                    "scheduled_utc": "2025-10-31T18:50:00Z",
                    "scheduled_local": "2025-10-31T14:50:00-04:00"
                },
                "aircraft": {
                    "model": "A340-600",
                    "state": "Active",
                    "family": "A340",
                    "icao24": "3c6509",
                    "type_code": "A346",
                    "manufacturer": "Airbus",
                    "registration": "D-AIHI"
                },
                "callsign": "DLH400",
                "departure": {
                    "gate": "Z68",
                    "airport": {
                        "city": "Frankfurt",
                        "iata": "FRA",
                        "icao": "EDDF",
                        "name": "Frankfurt Airport",
                        "country": "Germany",
                        "latitude": 50.03333,
                        "timezone": "Europe/Berlin",
                        "longitude": 8.57056,
                        "country_code": "DE"
                    },
                    "check_in": "259-335",
                    "terminal": "1",
                    "actual_utc": "2025-10-31T10:32:31Z",
                    "local_date": "2025-10-31",
                    "actual_local": "2025-10-31T11:32:31+01:00",
                    "estimated_utc": "2025-10-31T10:15:00Z",
                    "scheduled_utc": "2025-10-31T10:00:00Z",
                    "scheduled_local": "2025-10-31T11:00:00+01:00"
                },
                "codeshares": [
                    "UA8841",
                    "ET1610",
                    "NZ4226",
                    "SN7230",
                    "TG7722"
                ],
                "distance_km": 6196,
                "delay_minutes": {
                    "arrival": 3,
                    "departure": 33
                },
                "flight_number": "LH400"
            }
        ],
        "next_page": null,
        "delay_stats": {
            "weekly": [
                {
                    "week_start": "2026-05-19",
                    "on_time_percent": 94,
                    "median_delay_minutes": 19
                },
                {
                    "week_start": "2026-05-26",
                    "on_time_percent": 94,
                    "median_delay_minutes": 19
                }
            ],
            "flights": 30,
            "period_days": 30,
            "on_time_percent": 87,
            "typical_delay_minutes": -10
        },
        "flight_number": "LH400",
        "flights_per_month": [
            {
                "month": "2026-11",
                "flights": 14
            },
            {
                "month": "2026-10",
                "flights": 31
            },
            {
                "month": "2026-09",
                "flights": 31
            }
        ],
        "requested_flight_number": "LH400"
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "flight_history"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | Flightera has no data for this flight, registration, airport or route. This response is not billable. |
| 503 | Service Unavailable | Flightera 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)
