# FlightStats Flight Status API Documentation

<p><strong>FlightStats Flight Status API Documentation</strong> Read one flight by carrier code, flight number and date. The answer has the status and phase, delay minutes, the scheduled, estimated and actual gate times, the actual runway times (took off, landed), terminal, gate and baggage belt, the aircraft type and tail number, the operating carrier and the codeshare flight numbers. Every time comes twice: <code>*_utc</code> is ISO 8601 UTC with Z, <code>*_local</code> is ISO 8601 with the offset of the airport. Add <code>include=other_days</code> for the flight ids of the days around the date and <code>include=positions</code> for the track points. Live window only: FlightStats answers flights from 4 days back (3 days guaranteed) to 3 days ahead, and airport boards from 7 days back to 3 days ahead, counted in UTC days. Older days are not available and answer 422. Scrappa cannot return flight history older than that. A flight that does not operate on the date answers 404. Cost: 1 credit per successful request. Failures, 404 and 422 are never charged.</p>

- **Documentation:** [https://scrappa.co/docs/flightstats-api/flightstats_flight](https://scrappa.co/docs/flightstats-api/flightstats_flight)
- **API group:** FlightStats API
- **Endpoint:** `GET https://scrappa.co/api/flightstats/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 |
| --- | --- | --- | --- |
| `carrier` | string | Yes | IATA carrier code, e.g. LH. Find one with the search endpoint. |
| `flight_number` | string | Yes | Flight number without the carrier code, 1 to 4 digits, e.g. 400. |
| `date` | string | Yes | Scheduled departure date at the origin airport, YYYY-MM-DD. Window: 4 days back to 3 days ahead (UTC days). |
| `include` | string | No | Comma list: other_days (flight ids of the days around the date), positions (track points of a tracked or finished flight). |

## Example response

```json
{
    "data": {
        "date": "2026-11-13",
        "flight": {
            "status": {
                "code": "L",
                "text": "Arrived",
                "final": true,
                "phase": "Landed",
                "landed": true,
                "canceled": false,
                "diverted": false,
                "description": "Delayed by 6h 32m",
                "delay_arrival_minutes": 392,
                "delay_departure_minutes": 400
            },
            "arrival": {
                "city": "New York",
                "gate": "5",
                "iata": "JFK",
                "name": "New York John F. Kennedy International Airport",
                "state": "NY",
                "baggage": null,
                "country": "US",
                "terminal": "1",
                "timezone": "America/New_York",
                "actual_utc": "2026-11-14T01:07:00Z",
                "local_date": "2026-11-13",
                "actual_local": "2026-11-13T20:07:00-05:00",
                "estimated_utc": null,
                "scheduled_utc": "2026-11-13T18:35:00Z",
                "estimated_local": null,
                "scheduled_local": "2026-11-13T13:35:00-05:00",
                "actual_is_runway": false,
                "runway_actual_utc": "2026-11-14T01:07:00Z",
                "runway_actual_local": "2026-11-13T20:07:00-05:00"
            },
            "carrier": {
                "iata": "LH",
                "name": "Lufthansa"
            },
            "aircraft": {
                "callsign": "DLH400",
                "type_iata": "359",
                "type_name": "Airbus A350-900",
                "tail_number": "D-AIXD"
            },
            "duration": "8h 27m",
            "departure": {
                "city": "Frankfurt",
                "gate": "Z66",
                "iata": "FRA",
                "name": "Frankfurt Airport",
                "state": null,
                "baggage": null,
                "country": "DE",
                "terminal": "1",
                "timezone": "Europe/Berlin",
                "actual_utc": "2026-11-13T16:40:00Z",
                "local_date": "2026-11-13",
                "actual_local": "2026-11-13T17:40:00+01:00",
                "estimated_utc": null,
                "scheduled_utc": "2026-11-13T10:00:00Z",
                "estimated_local": null,
                "scheduled_local": "2026-11-13T11:00:00+01:00",
                "actual_is_runway": false,
                "runway_actual_utc": "2026-11-13T16:40:00Z",
                "runway_actual_local": "2026-11-13T17:40:00+01:00"
            },
            "flight_id": "1419597887",
            "positions": [
                {
                    "lat": 40.644552,
                    "lon": -73.738109,
                    "course": 50,
                    "speed_mph": 205,
                    "altitude_ft": 503,
                    "observed_utc": "2026-11-14T00:43:56Z"
                }
            ],
            "codeshares": [
                {
                    "carrier": {
                        "iata": "ET",
                        "name": "Ethiopian Airlines"
                    },
                    "flight_number": "1610"
                },
                {
                    "carrier": {
                        "iata": "NZ",
                        "name": "Air New Zealand"
                    },
                    "flight_number": "4226"
                },
                {
                    "carrier": {
                        "iata": "SN",
                        "name": "Brussels Airlines"
                    },
                    "flight_number": "7230"
                },
                {
                    "carrier": {
                        "iata": "TG",
                        "name": "Thai Airways International"
                    },
                    "flight_number": "7722"
                },
                {
                    "carrier": {
                        "iata": "UA",
                        "name": "United Airlines"
                    },
                    "flight_number": "8841"
                }
            ],
            "other_days": [
                {
                    "flight_id": "1419238360",
                    "arrival_airport": "JFK",
                    "departure_airport": "FRA",
                    "scheduled_departure_utc": "2026-11-11T10:00:00Z"
                },
                {
                    "flight_id": "1419411053",
                    "arrival_airport": "JFK",
                    "departure_airport": "FRA",
                    "scheduled_departure_utc": "2026-11-12T10:00:00Z"
                }
            ],
            "diverted_to": null,
            "operated_by": null,
            "flight_number": "400"
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "flight"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid, or the date is outside the window. This response is not billable. |
| 404 | Not Found | FlightStats has no flight for this carrier, number and date. This response is not billable. |
| 422 | Date Out Of Range | FlightStats refused a day it no longer serves. This response is not billable. |
| 503 | Upstream Unavailable | FlightStats could not be read after retries. 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)
