Skip to content
Scrappa Get API key
Flightera API 1 credit / request

Flightera Airport Board API Documentation

GET https://scrappa.co/api/flightera/airport-board

Flightera Airport Board API Documentation Departures or arrivals of an airport around one hour of one day, back to October 2017. Name the airport with an ICAO or IATA code or a city name. Flightera lists 10 flights per hour slot, so a busy hub can have more flights in that hour. The answer never claims a full day: request every hour to read a day. Every flight has times, delay minutes, gates, aircraft and airline. Cost: 1 credit per request. An empty answer is free.

Flightera Airport Board API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/flightera/airport-board
Auth header
x-api-key
Cost
1 credit / request
airport = example
Response preview
200 OK
{
    "data": {
        "date": "2025-10-15",
        "hour": 12,
        "count": 10,
        "airport": {
            "city": "Frankfurt",
            "icao": "EDDF",
            "name": "Frankfurt Airport",
            "country": "Germany",
            "latitude": 50.03333,
            "timezone": "Europe/Berlin",
            "longitude": 8.57056
        },
...

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.

3 optional filters available.

airport string Required

ICAO or IATA code or name, e.g. EDDF, FRA or Frankfurt.

Example value example
direction string Optional

departure (default) or arrival.

Example value example
date string Optional

UTC day, YYYY-MM-DD, from 2017-10-01. Defaults to today.

Example value 2026-06-15
hour integer Optional

Hour of the day, 0 to 23, in UTC. Defaults to the current hour.

Example value 10

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": "2025-10-15",
        "hour": 12,
        "count": 10,
        "airport": {
            "city": "Frankfurt",
            "icao": "EDDF",
            "name": "Frankfurt Airport",
            "country": "Germany",
            "latitude": 50.03333,
            "timezone": "Europe/Berlin",
            "longitude": 8.57056
        },
        "flights": [
            {
                "date": "2025-10-15",
                "status": "landed",
                "airline": {
                    "iata": "KJ",
                    "icao": "AIH",
                    "name": "Air Incheon",
                    "country": "United Kingdom"
                },
                "arrival": {
                    "gate": null,
                    "airport": {
                        "city": "Seoul",
                        "iata": "ICN",
                        "icao": "RKSI",
                        "name": "Seoul Incheon International Airport",
                        "country": "South Korea",
                        "latitude": 37.46333,
                        "timezone": "Asia/Seoul",
                        "longitude": 126.44,
                        "country_code": "KR"
                    },
                    "terminal": null,
                    "actual_utc": "2025-10-16T00:28:07Z",
                    "local_date": "2025-10-16",
                    "actual_local": "2025-10-16T09:28:07+09:00",
                    "estimated_utc": null,
                    "scheduled_utc": "2025-10-15T21:40:00Z",
                    "scheduled_local": "2025-10-16T06:40:00+09:00"
                },
                "aircraft": {
                    "model": "B747-400",
                    "state": "Active",
                    "family": "B747",
                    "icao24": "71be45",
                    "type_code": "B744",
                    "manufacturer": "Boeing",
                    "registration": "HL7645"
                },
                "callsign": "AIH796",
                "departure": {
                    "gate": null,
                    "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": null,
                    "terminal": null,
                    "actual_utc": "2025-10-15T13:44:44Z",
                    "local_date": "2025-10-15",
                    "actual_local": "2025-10-15T15:44:44+02:00",
                    "estimated_utc": null,
                    "scheduled_utc": "2025-10-15T10:00:00Z",
                    "scheduled_local": "2025-10-15T12:00:00+02:00"
                },
                "codeshares": [],
                "distance_km": 8552,
                "delay_minutes": {
                    "arrival": 168,
                    "departure": 225
                },
                "flight_number": "KJ796"
            }
        ],
        "direction": "departure",
        "coverage_note": "Flightera lists 10 flights per hour slot. A busy airport can have more flights in that hour. Request every hour to read a day."
    },
    "meta": {
        "credits": 1,
        "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 missing or invalid. This response is not billable.

{
    "errors": {
        "airport": [
            "The airport field is required."
        ]
    },
    "message": "The request validation failed"
}
404

Not Found

Flightera has no data for this flight, registration, airport or route. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": false,
        "endpoint_family": "airport_board"
    },
    "error": {
        "code": "NOT_FOUND",
        "message": "Flightera has no data for this flight, registration, airport or route."
    },
    "success": false
}
503

Service Unavailable

Flightera could not be reached or changed its answer. This response is not billable. Retry later.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "airport_board"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "The Flightera source 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.