# RadarBox Airport API Documentation

<p><strong>RadarBox Airport API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/radarbox-api/radarbox_airport](https://scrappa.co/docs/radarbox-api/radarbox_airport)
- **API group:** RadarBox API
- **Endpoint:** `GET https://scrappa.co/api/radarbox/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 |
| --- | --- | --- | --- |
| `airport` | string | Yes | ICAO or IATA code, e.g. EDDF or FRA. |
| `direction` | string | No | departures (default) or arrivals. |
| `date` | string | No | UTC day, YYYY-MM-DD, inside the 7 day window. |
| `page` | integer | No | Page 1 to 200. Page 1 is the latest. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | RadarBox has no data for this airport or flight. This response is not billable. |
| 503 | Service Unavailable | RadarBox could not be reached or changed its answer. 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)
