# Flightera Route API Documentation

<p><strong>Flightera Route API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/flightera-api/flightera_route](https://scrappa.co/docs/flightera-api/flightera_route)
- **API group:** Flightera API
- **Endpoint:** `GET https://scrappa.co/api/flightera/route`

## 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 |
| --- | --- | --- | --- |
| `origin` | string | Yes | Origin airport, ICAO or IATA code or name, e.g. EDDF or FRA. |
| `destination` | string | Yes | Destination airport, ICAO or IATA code or name, e.g. KJFK or JFK. |
| `month` | string | No | One month, YYYY-MM, from 2018-01. |
| `date` | string | No | UTC day, YYYY-MM-DD, from 2018-03-01. |
| `hour` | integer | No | Hour of the day, 0 to 23, in UTC. Needs date. Defaults to 12. |

## Example response

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

| 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)
