Airport Routes
List all routes from or to a specific airport. Returns route items with airlines, distance, and duration — useful for hub airport network views and schedule enrichment.
Requirements
Auth
x-api-key on every request (direct subscription). Learn more →Request
GET
https://data.skylinkapi.com/v3.1/routes/airport/{code}| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | - | Airport IATA (3-letter, e.g. MXP) or ICAO (4-letter, e.g. LIMC) |
direction | string | No | both | dep (departures), arr (arrivals), or both |
limit | integer | No | 100 | Maximum results (1–500) |
Response
{
"code": "JFK",
"direction": "dep",
"count": 3,
"routes": [
{
"departure": "JFK",
"arrival": "LHR",
"airlines": ["American Airlines", "British Airways", "Delta Air Lines"],
"km": 5555,
"duration_min": 430
}
]
}| Field | Type | Required | Description |
|---|---|---|---|
code | string | Yes | Echo of the requested airport code |
direction | string | Yes | Applied direction filter |
count | integer | Yes | Number of route rows returned |
routes | array | Yes | Route pair rows (may be empty) |
Route item (routes[])
| Field | Type | Required | Description |
|---|---|---|---|
departure | string | Yes | Departure airport code (IATA or ICAO as stored) |
arrival | string | Yes | Arrival airport code |
airlines | array | Yes | Carrier names serving the route |
km | integer | Yes | Great-circle distance in kilometres |
duration_min | integer | Yes | Typical block time in minutes |
Client types
"""Route detection response models for /routes/* endpoints."""from __future__ import annotationsfrom dataclasses import dataclass@dataclassclass RoutePair: departure: str arrival: str airlines: list[str] km: int duration_min: int@dataclassclass CallsignRouteResponse: """Exact callsign match from GET /routes/callsign/{callsign}.""" callsign: str callsign_prefix: str airline_code: str departure_icao: str arrival_icao: str airports: list[str] confidence: str source: str routes: list[RoutePair] | None = None@dataclassclass AirportRoutesResponse: code: str direction: str count: int routes: list[RoutePair]@dataclassclass RoutePairsResponse: count: int routes: list[RoutePair]@dataclassclass RouteGuess: """Shape returned by route_guess() helper.""" callsign: str departure: str | None arrival: str | None confidence: str source: strIntegration
Implementation notes
Pagination. Use limit when building hub maps; default caps keep payloads manageable.
Airport code mixing. Route rows may use IATA or ICAO depending on the source row — normalize through Airports before joining with other datasets.
Great-circle distance only. For precise distance and bearing between two known points, see Distance & Bearing.
Error responses
Validation 422: Routes hub.
x-api-key<token>
Your SkyLink licence key, for keys bought direct from skylinkapi.com.
In: header
Path Parameters
code*Code
Query Parameters
direction?Direction
'dep', 'arr', or 'both'
Default
"both"limit?Limit
Max results (default 100, max 500)
Default
100Range
1 <= value <= 500Response Body
application/json
application/json
curl -X GET "https://data.skylinkapi.com/v3.1/routes/airport/US"null{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}