Skip to content
Scrappa Get API key
RadarBox API 8 credits / request

RadarBox Airport API Documentation

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

RadarBox Airport API Documentation Departures or arrivals of one airport from AirNav RadarBox, 30 flights per page. Send an ICAO or IATA code. Page 1 is the latest, higher pages go back in time, about 180 pages cover 7 days at a large hub. Every flight has the same fields as flight-history. A date outside the window answers an empty list. An empty page is free. Cost: 8 credits for each page with flights. RadarBox shows 7 days back and 2 days ahead without a login. A date outside this window answers 200 with an empty list, depth_limit_days 7 and a note, and costs nothing. An older leg is reachable only by its fid (measured back to 2020-12-02). For flight number and date lookups far back, use /api/flightera/flight.

RadarBox Airport API Documentation 8 credits / request

Endpoint

Request preview
GET
https://scrappa.co/api/radarbox/airport
Auth header
x-api-key
Cost
8 credits / request
airport = example
Response preview
200 OK
{
    "data": {
        "count": 1,
        "query": {
            "date": null,
            "page": 1,
            "airport": "EDDF",
            "direction": "departures"
        },
        "airport": {
            "city": "Frankfurt",
            "iata": "FRA",
            "icao": "EDDF",
            "name": "Frankfurt am Main International Airport",
...

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, e.g. EDDF or FRA.

Example value example
direction string Optional

departures (default) or arrivals.

Example value example
date string Optional

UTC day, YYYY-MM-DD, inside the 7 day window.

Example value 2026-06-15
page integer Optional

Page 1 to 200. Page 1 is the latest.

Example value 1

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": {
        "count": 1,
        "query": {
            "date": null,
            "page": 1,
            "airport": "EDDF",
            "direction": "departures"
        },
        "airport": {
            "city": "Frankfurt",
            "iata": "FRA",
            "icao": "EDDF",
            "name": "Frankfurt am Main International Airport",
            "state": "Hesse",
            "country": "Germany",
            "latitude": 50.0264,
            "longitude": 8.54313,
            "timezone_name": "Central European Standard Time",
            "timezone_abbreviation": "CET",
            "timezone_offset_hours": 1
        },
        "flights": [
            {
                "fid": 3017934576,
                "date": "2026-11-17",
                "status": "scheduled",
                "airline": {
                    "iata": "SQ",
                    "icao": "SIA",
                    "name": "Singapore Airlines",
                    "operating_iata": "SQ",
                    "operating_icao": "SIA",
                    "operating_name": "Singapore Airlines"
                },
                "arrival": {
                    "gate": null,
                    "actual": null,
                    "airport": {
                        "city": "Singapore",
                        "iata": "SIN",
                        "icao": "WSSS",
                        "name": "Singapore Changi International Airport",
                        "state": "South East",
                        "country": "Singapore",
                        "latitude": 1.35019,
                        "longitude": 103.994,
                        "timezone_name": "Singapore Standard Time",
                        "timezone_abbreviation": "SGT",
                        "timezone_offset_hours": 8
                    },
                    "terminal": "0",
                    "estimated": null,
                    "scheduled": "2026-11-17T22:50:00Z",
                    "local_date": "2026-11-18",
                    "baggage_belt": null,
                    "scheduled_local": "2026-11-18T06:50:00+08:00"
                },
                "aircraft": {
                    "mode_s": null,
                    "country": null,
                    "type_icao": "B77W",
                    "type_name": "Boeing 777-300ER",
                    "registration": null
                },
                "callsign": null,
                "departure": {
                    "gate": null,
                    "actual": null,
                    "airport": {
                        "city": "Frankfurt",
                        "iata": "FRA",
                        "icao": "EDDF",
                        "name": "Frankfurt am Main International Airport",
                        "state": "Hesse",
                        "country": "Germany",
                        "latitude": 50.0264,
                        "longitude": 8.54313,
                        "timezone_name": "Central European Standard Time",
                        "timezone_abbreviation": "CET",
                        "timezone_offset_hours": 1
                    },
                    "terminal": "1",
                    "estimated": null,
                    "scheduled": "2026-11-17T10:25:00Z",
                    "local_date": "2026-11-17",
                    "baggage_belt": null,
                    "scheduled_local": "2026-11-17T11:25:00+01:00"
                },
                "alias_fids": [],
                "codeshares": [],
                "distance_km": 10284.2,
                "duration_type": "scheduled",
                "flight_number": "SQ25",
                "duration_minutes": 745,
                "progress_percent": 0,
                "flight_number_icao": "SIA25",
                "delay_arrival_minutes": null,
                "delay_departure_minutes": null
            }
        ]
    },
    "meta": {
        "page": 1,
        "credits": 8,
        "billable": true,
        "has_more": true,
        "depth_note": "RadarBox lists show 7 days back and 2 days ahead without a login. An older leg is reachable only by its fid (measured back to 2020-12-02). For flight number and date lookups far back, use /api/flightera/flight.",
        "endpoint_family": "airport",
        "window_days_back": 7,
        "window_days_forward": 2
    },
    "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": [
            "An airport is required: an ICAO or IATA code such as EDDF or FRA."
        ]
    },
    "message": "The request validation failed"
}
404

Not Found

RadarBox has no data for this airport or flight. This response is not billable.

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

Service Unavailable

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

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