Errors

Error responses use standard HTTP status codes and a consistent JSON error shape.

Error shape

Errors return a JSON body with a stable machine-readable code:

{
  "error": { "code": "insufficient_credits", "message": "…" },
  "requestId": "…"
}

Status codes

400 invalid request body (not billed) · 401 missing/invalid key · 402 insufficient credits · 502/503 upstream data provider unavailable (not billed) · 500 internal error (not billed). Every response includes a requestId for support.