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"
  }
}
StatusCodeMeaning
400invalid_parameterA parameter is missing or wrong. error.param says which one.
401invalid_api_keyNo key, or a wrong, expired or revoked key.
403insufficient_scopeThe key can't read this: live data or personal details.
403activity_not_allowedThe key is limited to other activities.
404not_foundUnknown path, report type or activity.
405method_not_allowedThe API is read-only: only GET works.
429rate_limitedToo many requests. Wait for the seconds in Retry-After.
500internal_errorSomething failed on our side. Try again later, and quote request_id if it keeps failing.
Errors — Planifizer API docs