Skip to content
Scrappa Get API key
FlightStats API 2-12 credits / request

FlightStats Airport Board API Documentation

GET https://scrappa.co/api/flightstats/airport

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.

FlightStats Airport Board API Documentation 2-12 credits / request

Endpoint

Request preview
GET
https://scrappa.co/api/flightstats/airport
Auth header
x-api-key
Cost
2-12 credits / request
iata = example
Response preview
200 OK
{
    "data": {
        "date": "2026-11-13",
        "hour": 6,
        "mode": "departures",
        "rows": [
            {
                "carrier": {
                    "iata": "TP",
                    "name": "TAP Air Portugal"
                },
                "flight_id": "1419619821",
                "codeshares": [
                    {
...

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.

iata string Required

Airport IATA code, e.g. FRA.

Example value example
mode string Optional

departures (default) or arrivals.

Example value example
date string Optional

Local date of the airport, YYYY-MM-DD. Default: today (UTC). Window: 7 days back to 3 days ahead (UTC days).

Example value 2026-06-15
hour integer Optional

First local hour of the window, 0 to 23. Default: 0.

Example value 10
hours integer Optional

Length of the window in hours, 1 to 12. Default: 12.

Example value 10
carrier string Optional

Only flights of this IATA carrier code, e.g. LH.

Example value example
limit integer Optional

Rows to return, 1 to 500. Default: 100. The answer has the total of the window.

Example value 10
detail boolean Optional

true completes the first 10 rows with status, gate, terminal and delay. Costs 1 more credit per completed row. Default: false.

Example value true

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "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.

422

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"
}
404

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
}
503

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.