Errors

REST errors use standard HTTP status codes and one JSON error shape with a machine-readable code and a requestId you can quote to support.

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 funds · 502/503 upstream data provider unavailable (not billed) · 500 internal error (not billed). Every response includes a requestId for support.