FlightStats Airport Board API Documentation 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 scheduled_utc (Z) and scheduled_local (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 detail=true to complete the first 10 rows with status, gate, terminal and delay, for 1 more credit per completed row. hour and hours 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.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
7 optional filters available.
string
Required
Airport IATA code, e.g. FRA.
example
string
Optional
departures (default) or arrivals.
example
string
Optional
Local date of the airport, YYYY-MM-DD. Default: today (UTC). Window: 7 days back to 3 days ahead (UTC days).
2026-06-15
integer
Optional
First local hour of the window, 0 to 23. Default: 0.
10
integer
Optional
Length of the window in hours, 1 to 12. Default: 12.
10
string
Optional
Only flights of this IATA carrier code, e.g. LH.
example
integer
Optional
Rows to return, 1 to 500. Default: 100. The answer has the total of the window.
10
boolean
Optional
true completes the first 10 rows with status, gate, terminal and delay. Costs 1 more credit per completed row. Default: false.
true
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"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
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is invalid, or the date is outside the window. This response is not billable.
{
"errors": {
"date": [
"FlightStats answers airport boards from 2026-11-07 to 2026-11-17 (UTC days). Older boards are not available here. Use the Flightera API (flightera/airport-board) for older airport boards."
]
},
"message": "The request validation failed"
}Not Found
The airport is not known or has no board for this date. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "airport_board"
},
"error": {
"code": "NOT_FOUND",
"message": "FlightStats has no data for this flight or airport on this date."
},
"success": false
}Upstream Unavailable
FlightStats could not be read after retries. This response is not billable. Retry later.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "airport_board"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "FlightStats 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.