# Flightera Flight API Documentation

<p><strong>Flightera Flight API Documentation</strong> One flight by flight number and UTC departure date. The answer has scheduled, estimated and actual times in UTC and local time, delay minutes, gates, terminals, aircraft with registration, airline and both airports. When a number flies twice on one day, the other flights are in other_legs. A day without a flight answers 200 with flight null and costs nothing. Cost: 1 credit for each page read, usually 2.</p>

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

## 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 | Yes | UTC departure day, YYYY-MM-DD. Flights are listed from 2017-09-01. |

## Example response

```json
{
    "data": {
        "date": "2025-10-15",
        "flight": {
            "date": "2025-10-15",
            "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-15T16:50:09Z",
                "local_date": "2025-10-15",
                "actual_local": "2025-10-15T12:50:09-04:00",
                "estimated_utc": null,
                "scheduled_utc": "2025-10-15T17:20:00Z",
                "scheduled_local": "2025-10-15T13:20:00-04:00"
            },
            "aircraft": {
                "model": "B747-400",
                "state": "Active",
                "family": "B747",
                "icao24": "3c4a8c",
                "type_code": "B744",
                "manufacturer": "Boeing",
                "registration": "D-ABTL"
            },
            "callsign": "DLH400",
            "departure": {
                "gate": "Z23",
                "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-15T09:13:09Z",
                "local_date": "2025-10-15",
                "actual_local": "2025-10-15T11:13:09+02:00",
                "estimated_utc": "2025-10-15T09:03:00Z",
                "scheduled_utc": "2025-10-15T08:55:00Z",
                "scheduled_local": "2025-10-15T10:55:00+02:00"
            },
            "codeshares": [
                "UA8841",
                "ET1610",
                "NZ4226",
                "SN7230",
                "TG7722"
            ],
            "distance_km": 6196,
            "delay_minutes": {
                "arrival": -30,
                "departure": 18
            },
            "flight_number": "LH400"
        },
        "other_legs": [],
        "flight_number": "LH400",
        "requested_flight_number": "LH400"
    },
    "meta": {
        "credits": 2,
        "billable": true,
        "endpoint_family": "flight"
    },
    "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)
