ERROR TAXONOMYRFC 7807

Error Reference & Codes

Verixa ID uses conventional HTTP response codes to indicate the success or failure of an API request.

HTTP Status	Error Code	Description
200 OK	None	Request succeeded. Identity verified or lookup resolved.
400 Bad Request	parameter_missing / invalid_bvn	Missing required parameters or malformed payload.
401 Unauthorized	invalid_api_key	Invalid, revoked, or missing API token.
402 Payment Required	insufficient_credits	NGX credit balance is too low to perform lookup.
429 Too Many Requests	rate_limit_exceeded	Exceeded rate limit for the organization.

Standard Error Payload Format

Error Response Schema

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_missing",
    "message": "The 'bvn' parameter is required and must be an 11-digit string.",
    "param": "bvn",
    "request_id": "vx_req_err_8f19a02d"
  }
}