# FlightStats Airport Board API Documentation

<p><strong>FlightStats Airport Board API Documentation</strong> Read the departures or arrivals of an airport for one local date and a window of hours. Each row is one operating flight with carrier, flight number, flight id, the other airport and the scheduled time as <code>scheduled_utc</code> (Z) and <code>scheduled_local</code> (with offset). Codeshare flight numbers are grouped under the operating flight, so no flight appears twice. The answer also has the airport with position, delay index and weather. The board holds the schedule only. Add <code>detail=true</code> to complete the first 10 rows with status, gate, terminal and delay, for 1 more credit per completed row. <code>hour</code> and <code>hours</code> are local hours of the airport. 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. An unknown airport answers 404. A window with no flight is free. Cost: 2 credits per successful request. Failures, 404 and 422 are never charged.</p>

- **Documentation:** [https://scrappa.co/docs/flightstats-api/flightstats_airport](https://scrappa.co/docs/flightstats-api/flightstats_airport)
- **API group:** FlightStats API
- **Endpoint:** `GET https://scrappa.co/api/flightstats/airport`

## 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 |
| --- | --- | --- | --- |
| `iata` | string | Yes | Airport IATA code, e.g. FRA. |
| `mode` | string | No | departures (default) or arrivals. |
| `date` | string | No | Local date of the airport, YYYY-MM-DD. Default: today (UTC). Window: 7 days back to 3 days ahead (UTC days). |
| `hour` | integer | No | First local hour of the window, 0 to 23. Default: 0. |
| `hours` | integer | No | Length of the window in hours, 1 to 12. Default: 12. |
| `carrier` | string | No | Only flights of this IATA carrier code, e.g. LH. |
| `limit` | integer | No | Rows to return, 1 to 500. Default: 100. The answer has the total of the window. |
| `detail` | boolean | No | true completes the first 10 rows with status, gate, terminal and delay. Costs 1 more credit per completed row. Default: false. |

## Example response

```json
{
    "data": {
        "date": "2026-11-13",
        "hour": 6,
        "mode": "departures",
        "rows": [
            {
                "carrier": {
                    "iata": "TP",
                    "name": "TAP Air Portugal"
                },
                "flight_id": "1419619821",
                "codeshares": [
                    {
                        "carrier": {
                            "iata": "AD",
                            "name": "Azul"
                        },
                        "flight_number": "7225"
                    },
                    {
                        "carrier": {
                            "iata": "LH",
                            "name": "Lufthansa"
                        },
                        "flight_number": "6954"
                    }
                ],
                "local_date": "2026-11-13",
                "flight_date": "2026-11-13",
                "operated_by": null,
                "flight_number": "575",
                "other_airport": {
                    "city": "Lisbon",
                    "iata": "LIS"
                },
                "scheduled_utc": "2026-11-13T05:00:00Z",
                "scheduled_local": "2026-11-13T06:00:00+01:00"
            },
            {
                "carrier": {
                    "iata": "X3",
                    "name": "TUIfly"
                },
                "flight_id": "1419639244",
                "codeshares": [],
                "local_date": "2026-11-13",
                "flight_date": "2026-11-13",
                "operated_by": null,
                "flight_number": "2128",
                "other_airport": {
                    "city": "Palma de Mallorca",
                    "iata": "PMI"
                },
                "scheduled_utc": "2026-11-13T05:00:00Z",
                "scheduled_local": "2026-11-13T06:00:00+01:00"
            }
        ],
        "count": 2,
        "hours": 1,
        "total": 47,
        "airport": {
            "city": "Frankfurt",
            "iata": "FRA",
            "icao": "EDDF",
            "name": "Frankfurt Airport",
            "country": "DE",
            "weather": {
                "wind_kph": 7,
                "temperature_c": 1,
                "visibility_km": 10
            },
            "latitude": 50.048952,
            "timezone": "Europe/Berlin",
            "longitude": 8.573678,
            "delay_index": {
                "score": 3.25,
                "trend": "Increasing",
                "status": "Significant"
            }
        }
    },
    "meta": {
        "credits": 2,
        "billable": true,
        "endpoint_family": "airport_board"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is invalid, or the date is outside the window. This response is not billable. |
| 404 | Not Found | The airport is not known or has no board for this date. 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)
