VeroID

Errors

Error handling and response codes

VeroID uses standard HTTP status codes and returns detailed error information in JSON format.

HTTP Status Codes

CodeMeaning
200Success
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing API key
402Payment Required - Insufficient credits
404Not Found - Resource doesn't exist
429Too Many Requests - Rate limited
500Internal 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

LimitValue
Requests per second10
Requests per minute100
Requests per hour1,000