Errors
Error code registry
All errors follow RFC 7807 problem-details. The stable identifier is the type URN; clients should look up localized messages
on that code rather than parsing the English title. Below is the full registry,
derived at build time from
https://api.c0.lt/openapi.json
.
| Code | HTTP | Title | Description |
|---|---|---|---|
| urn:codus-nullus:voice:problem:auth.invalid_credentials | 401 | Invalid credentials | Email + password combination did not match. Common fix: reset password via /auth/forgot-password. |
| urn:codus-nullus:voice:problem:auth.token_expired | 401 | Access token expired | Refresh via POST /v1/auth/refresh with the refresh_token. |
| urn:codus-nullus:voice:problem:auth.token_invalid | 401 | Access token invalid | Token failed signature verification or was revoked. Sign in again. |
| urn:codus-nullus:voice:problem:balance.insufficient | 402 | Insufficient prepaid balance | Top-up of at least EUR 10 is required. |
| urn:codus-nullus:voice:problem:auth.forbidden | 403 | Forbidden | Authenticated, but the role does not permit this action. |
| urn:codus-nullus:voice:problem:not_found | 404 | Resource not found | The id does not exist or is not visible to your account. |
| urn:codus-nullus:voice:problem:idempotency.conflict | 409 | Idempotency-Key conflict | Same Idempotency-Key was used with a different request body. Generate a fresh UUID. |
| urn:codus-nullus:voice:problem:validation.failed | 422 | Validation failed | Request body failed schema validation. See `invalid_params` for the per-field reasons. |
| urn:codus-nullus:voice:problem:rate_limited | 429 | Rate limit exceeded | Wait `retry_after` seconds before retrying. |
| urn:codus-nullus:voice:problem:internal | 500 | Internal server error | Unexpected error. The request id in the response can be referenced in support tickets. |
| urn:codus-nullus:voice:problem:upstream.unavailable | 503 | Upstream carrier unavailable | Transient upstream failure. Retry with the same Idempotency-Key. |
Showing 11 unique error codes from api.c0.lt.