Reference
Errors
Errors use the HTTP status and a JSON body with a stable code, a sentence that says what to fix, and the parameter at fault when there is one.
{
"error": {
"code": "invalid_parameter",
"message": "week must be an ISO week such as 2026-W42.",
"param": "week",
"request_id": "4e55466a-a086-42f6-92eb-66f21e89c63d"
}
}| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_parameter | A parameter is missing or wrong. error.param says which one. |
| 401 | invalid_api_key | No key, or a wrong, expired or revoked key. |
| 403 | insufficient_scope | The key can't read this: live data or personal details. |
| 403 | activity_not_allowed | The key is limited to other activities. |
| 404 | not_found | Unknown path, report type or activity. |
| 405 | method_not_allowed | The API is read-only: only GET works. |
| 429 | rate_limited | Too many requests. Wait for the seconds in Retry-After. |
| 500 | internal_error | Something failed on our side. Try again later, and quote request_id if it keeps failing. |