DocsAPI ReferenceErrors
API Errors Reference
Details of status codes and error payload structures.
JSON Error Structure
When an API request results in an error, the server returns a standard JSON error response containing a machine-readable code and a human-readable description.
json
{"error": {"code": "invalid_api_key","message": "The provided API key is invalid or has expired."}}
Error Status Codes
Reference list of common HTTP response codes returned by the VeriLens API:
| HTTP Status | Error Code | Possible Cause |
|---|---|---|
| 400 Bad Request | invalid_payload | Required parameters (like 'text') are missing or malformed. |
| 401 Unauthorized | invalid_api_key | The Authorization header is missing or the API key is invalid. |
| 403 Forbidden | tier_restricted | The requested model (e.g. Gemini Deep check) is not allowed on your free tier. |
| 429 Too Many Requests | rate_limit_exceeded | You have made too many requests in a short window. Slow down requests. |
| 500 Internal Error | server_error | An internal error occurred on our verification models. |