Errors

Every 4xx / 5xx returns the same JSON shape; the HTTP status tells you what happened.

{
  "error": "human readable message"
}

Status codes

400

Malformed query — non-RFC3339 time, end before start, invalid interval, missing or unsupported dimension, non-positive limit.

401

API token missing or invalid (X-API-Key).

404

The dataset series doesn't exist.

429

Rate limit exceeded. Wait the seconds in the Retry-After response header, then retry.

500

Server-side fault.