Skip to content

DevelopersGuides

Errors

One error shape and what each code means.

Errors other than 429 share one shape: { "code": "not_found", "message": "…" }. invalid_request adds errors, one per bad parameter.

CodeStatusWhen
invalid_request400A query or path parameter is missing or out of range.
invalid_key401The key is malformed, revoked or unknown. Leave it out to use the anonymous allowance.
not_found404No public item with that slug.
method_not_allowed405The API is read-only: GET (and OPTIONS) only.
rate_limited429Over a bucket or the global limit. Wait retry_after seconds.
internal_error500Something broke on our side. Retry with backoff.
JSON
{
  "code": "invalid_request",
  "message": "Some parameters are invalid.",
  "errors": [
    {
      "param": "limit",
      "message": "Too big: expected number to be <=100"
    }
  ]
}