API Error Codes & Retry Handling

Structured error responses, status codes, and exponential backoff guidelines.

HTTP Status Codes

200 OKRequest processed successfully or assessment rendered.

202 AcceptedVerification queued in the 8-model background worker. Listen to webhook or poll.

400 Bad RequestMalformed JSON payload or missing required `claim` / `text` parameters.

401 UnauthorizedInvalid or missing Bearer token in the `Authorization` header.

402 Payment RequiredMonthly verification quota exceeded. Upgrade tier in dashboard.

429 Too Many RequestsRate limit reached. Respect the `Retry-After` header.

500 Internal Server ErrorTemporary model endpoint timeout. Automatically retried with backoff.