Errors
Error handling and response codes
VeroID uses standard HTTP status codes and returns detailed error information in JSON format.
HTTP Status Codes
| Code | Meaning |
|---|---|
| 200 | Success |
| 400 | Bad Request - Invalid parameters |
| 401 | Unauthorized - Invalid or missing API key |
| 402 | Payment Required - Insufficient credits |
| 404 | Not Found - Resource doesn't exist |
| 429 | Too Many Requests - Rate limited |
| 500 | Internal Server Error |
Error Response Format
{
"error": "Error Type",
"code": "ERROR_CODE",
"message": "Human-readable description",
"verificationId": "ver_..."
}Authentication Errors (401)
{
"error": "Unauthorized",
"message": "Missing API key. Include X-API-Key header."
}Credit Errors (402)
{
"error": "Payment Required",
"message": "Insufficient credit balance. Please purchase more credits."
}Rate Limits
| Limit | Value |
|---|---|
| Requests per second | 10 |
| Requests per minute | 100 |
| Requests per hour | 1,000 |