Errors
Circa uses conventional HTTP status codes. Bodies are JSON with statusCode and message.
| Code | Meaning |
|---|---|
| 200 | Success |
| 400 | Bad Request — malformed parameters, unknown version, validation failure |
| 401 | Unauthorized — missing, invalid, or revoked API key |
| 403 | Forbidden — key valid but the requested action is not permitted |
| 404 | Not Found — resource does not exist or is not visible to your account |
| 409 | Conflict — e.g. insufficient credits to pull a datapoint |
| 422 | Unprocessable Entity — well-formed but semantically invalid |
| 429 | Too Many Requests — rate limit exceeded |
| 500 | Internal Server Error — try again, contact support if persistent |
Inspect failures fast
Every request you make is captured in your request log. Click any row to see the full request body, response body, headers, latency, and the API version that was applied. This is the fastest way to debug an integration.