Skip to content
Scrappa Get API key
Flightera API 1 credit / request

Flightera Route API Documentation

GET https://scrappa.co/api/flightera/route

Flightera Route API Documentation Flights of one route across all airlines, with route statistics such as the typical delay and duration. Name both airports with an ICAO or IATA code or a city name. Without a time the latest flights are returned. Add month (back to January 2018) or date with hour (back to March 2018, default hour 12). Each call shows 10 flights. Cost: 1 credit per request. An empty answer is free.

Flightera Route API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/flightera/route
Auth header
x-api-key
Cost
1 credit / request
origin = example destination = example
Response preview
200 OK
{
    "data": {
        "count": 10,
        "stats": {
            "summary": "On this route, approximately 87% of flights arrive on time. The average delay is 36 minutes.",
            "typical_delay": "37min",
            "typical_duration": "8h 43min"
        },
        "origin": {
            "city": "Frankfurt",
            "iata": "FRA",
            "icao": "EDDF"
        },
        "window": {
...

Parameters

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

Runnable path

2 required parameters needed before sending a request.

3 optional filters available.

origin string Required

Origin airport, ICAO or IATA code or name, e.g. EDDF or FRA.

Example value example
destination string Required

Destination airport, ICAO or IATA code or name, e.g. KJFK or JFK.

Example value example
month string Optional

One month, YYYY-MM, from 2018-01.

Example value example
date string Optional

UTC day, YYYY-MM-DD, from 2018-03-01.

Example value 2026-06-15
hour integer Optional

Hour of the day, 0 to 23, in UTC. Needs date. Defaults to 12.

Example value 10

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": 10,
        "stats": {
            "summary": "On this route, approximately 87% of flights arrive on time. The average delay is 36 minutes.",
            "typical_delay": "37min",
            "typical_duration": "8h 43min"
        },
        "origin": {
            "city": "Frankfurt",
            "iata": "FRA",
            "icao": "EDDF"
        },
        "window": {
            "from": "2025-10-15",
            "hour": 12
        },
        "flights": [
            {
                "date": "2025-10-15",
                "status": "landed",
                "airline": {
                    "iata": "LH",
                    "icao": "DLH",
                    "name": "Lufthansa",
                    "country": "Germany"
                },
                "arrival": {
                    "gate": "7",
                    "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-15T23:24:00Z",
                    "local_date": "2025-10-15",
                    "actual_local": "2025-10-15T19:24:00-04:00",
                    "estimated_utc": "2025-10-15T23:16:00Z",
                    "scheduled_utc": "2025-10-16T00:05:00Z",
                    "scheduled_local": "2025-10-15T20:05:00-04:00"
                },
                "aircraft": {
                    "model": "A340-300",
                    "state": "Active",
                    "family": "A340",
                    "icao24": "3c64f5",
                    "type_code": "A343",
                    "manufacturer": "Airbus",
                    "registration": "D-AIGU"
                },
                "callsign": "DLH404",
                "departure": {
                    "gate": "Z25",
                    "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-15T15:36:29Z",
                    "local_date": "2025-10-15",
                    "actual_local": "2025-10-15T17:36:29+02:00",
                    "estimated_utc": null,
                    "scheduled_utc": "2025-10-15T15:15:00Z",
                    "scheduled_local": "2025-10-15T17:15:00+02:00"
                },
                "codeshares": [
                    "NZ4224",
                    "SN7232",
                    "UA8843"
                ],
                "distance_km": 6196,
                "delay_minutes": {
                    "arrival": -41,
                    "departure": 21
                },
                "flight_number": "LH404"
            }
        ],
        "destination": {
            "city": "New York",
            "iata": "JFK",
            "icao": "KJFK"
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "route"
    },
    "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": {
        "origin": [
            "The origin 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": "route"
    },
    "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": "route"
    },
    "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.