Open data · API reference
Yearly open data packages (CC BY 4.0): releases, files, size and SHA-256; the same package downloads without a key on Atlas.
GET /v1/open-data
Published yearly open data packages (CC BY 4.0)
Authentication: X-Api-Key header; required scope: scope table.
Responses
| Status | Description | Content |
|---|---|---|
200 | Releases; Cache-Control: private, max-age=300 | application/json → OpenDataList |
401 | code: auth_missing, auth_invalid, auth_revoked | application/json → ErrorBody |
403 | code: auth_scope | application/json → ErrorBody |
429 | code: rate_limited, quota_exceeded (Retry-After seconds)Headers: Retry-After — Seconds until the exhausted window resets | application/json → ErrorBody |
GET /v1/open-data/{year}/{file}
Download one file of a yearly open data package
Authentication: X-Api-Key header; required scope: scope table.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
year required | path | integer | Release year2026 ≤ x ≤ 9999 |
file required | path | string | A file the manifest lists^(?:(?:thermals_r7|thermals_r9|sites|hazards|skyways)\.(?:parquet|geojson)|README\.md|LICENSE\.txt|manifest\.json)$ |
Responses
| Status | Description | Content |
|---|---|---|
200 | The file (folder stores) | application/octet-stream → string (binary) |
307 | Presigned object store URL, valid 10 minutes (S3 stores) | |
401 | code: auth_missing, auth_invalid, auth_revoked | application/json → ErrorBody |
403 | code: auth_scope | application/json → ErrorBody |
404 | code: open_data_not_found | application/json → ErrorBody |
422 | code: request_invalid | application/json → ErrorBody |
429 | code: rate_limited, quota_exceeded (Retry-After seconds)Headers: Retry-After — Seconds until the exhausted window resets | application/json → ErrorBody |