Errors
Errors come back as JSON. The shape depends on the endpoint.
{ "message": "human-readable message", "code": "...", "details": {} }
Time Series and Nearest Time:
{ "error": "human-readable message" }
| Status | Name | Meaning | What to do |
|---|---|---|---|
400 |
Bad Request | Validation error | Check the request against the parameter tables. |
401 |
Unauthorized | Missing or invalid API key | Send a valid key in X-API-Key. |
403 |
Forbidden | Not authorized for the requested stations | Request only stations in your entitled networks. |
404 |
Not Found | Station not found (GET /stations/{station_id}) |
Check the station id. |
408 |
Request Timeout | Request ran past the processing deadline (Time Series) | Use a shorter time range or fewer stations. |
413 |
Content Too Large | Request over your data-point limit (Time Series) | Set interval_seconds, use a shorter time range or fewer stations. See Data points. |
429 |
Too Many Requests | Too many requests from your organization at the same time | Retry after the time in the Retry-After header. |
500 |
Internal Server Error | Unexpected error on the Skyfora side | Try again. If it continues, contact Skyfora support. |
503 |
Service Unavailable | Service temporarily unavailable | Try again later. |