Route suggestions · API reference
A few unranked route options from a take-off for a local day and hour, with landing alternatives; pre-flight planning only, always shown with the fixed pre-flight notice.
GET /v1/routes
Route suggestions from a take-off for a day and hour (pre-flight planning only)
A few options in compass order, not ranked; each waypoint with landing alternatives, each option with reasons. Only where a region moderator marked the suggestions reasonable. The pilot decides; airspace and legal limits are checked separately (docs/10 §20).
Authentication: X-Api-Key header; required scope: scope table.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
takeoff_id required | query | string (uuid) | Public take-off id (GET /v1/sites) |
date | query | string (date) | null | Local date (Europe/Istanbul), today to today + 4 days; default today example "2026-11-06" |
hour | query | integer | null | Local hour 8-19 (Europe/Istanbul); default the next whole hour example 12 |
Responses
| Status | Description | Content |
|---|---|---|
200 | Options; Cache-Control header | application/json → RoutesResponse |
401 | code: auth_missing, auth_invalid, auth_revoked | application/json → ErrorBody |
403 | code: auth_scope | application/json → ErrorBody |
404 | code: site_not_found, routes_not_available | application/json → ErrorBody |
422 | code: request_invalid, date_out_of_range, hour_out_of_range | application/json → ErrorBody |
429 | code: rate_limited, quota_exceeded (Retry-After seconds)Headers: Retry-After — Seconds until the exhausted window resets | application/json → ErrorBody |