Skip to content
Scrappa Get API key
Flightera API 1-40 credits / request

Flightera Flight History API Documentation

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

Flightera Flight History API Documentation 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.

Flightera Flight History API Documentation 1-40 credits / request

Endpoint

Request preview
GET
https://scrappa.co/api/flightera/flight-history
Auth header
x-api-key
Cost
1-40 credits / request
flight_number = example
Response preview
200 OK
{
    "data": {
        "count": 1,
        "window": {
            "to": "2025-10-31",
            "from": "2025-10-31"
        },
        "flights": [
            {
                "date": "2025-10-31",
                "status": "landed",
                "airline": {
                    "iata": "LH",
                    "icao": "DLH",
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

5 optional filters available.

flight_number string Required

Flight number, e.g. LH400 or BA117. A codeshare number follows the operating flight.

Example value example
date string Optional

One UTC departure day, YYYY-MM-DD. Flights are listed from 2017-09-01.

Example value 2026-06-15
from string Optional

First day of a range, YYYY-MM-DD. The range is at most 190 days.

Example value example
to string Optional

Last day of a range, YYYY-MM-DD. Defaults to today. Needs from.

Example value example
month string Optional

One month, YYYY-MM. Returns 20 flights per page.

Example value example
page integer Optional

Page of a month, 1 to 5. Use next_page of the answer.

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,
        "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

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

Flightera has no data for this flight, registration, airport or route. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": false,
        "endpoint_family": "flight_history"
    },
    "error": {
        "code": "NOT_FOUND",
        "message": "Flightera has no data for this flight, registration, airport or route."
    },
    "success": false
}
503

Service Unavailable

Flightera 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 Flightera 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.