Skip to content

Errors

Standard HTTP status codes; error bodies are JSON with an `error` string.

All non-2xx responses share the same shape: { "error": "<message>" }.

Status codes

  • 400 Bad Request ·invalid request parameters (missing field, unknown indicator type)
  • 401 Unauthorized ·API key missing, invalid, or revoked
  • 403 Forbidden ·API key lacks the required permission (e.g. no enrich_bulk scope)
  • 404 Not Found ·resource (e.g. history record) does not exist
  • 429 Too Many Requests ·rate limit, quota, or bulk batch cap hit
  • 500 Internal Server Error ·unexpected failure; safe to retry with backoff
  • 503 Service Unavailable ·service is unhealthy or draining; retry later

Per-endpoint examples are listed under each operation's "Responses" section.