Skip to main content
For verification types not covered by the dedicated endpoints (credit checks, Kenya-specific verifications), use the generic verification endpoint.

Endpoint

POST /api/v1/business/verification/{verificationCode}
Signature required: Yes

Path parameters

ParameterTypeRequiredDescription
verificationCodestringYesThe verification type code (see supported codes below)

Request body

FieldTypeRequiredDescription
payloadobjectYesKey-value pairs specific to the verification type
idempotencyKeystringNoUnique key to prevent duplicate charges

Supported verification codes

CodeDescriptionRequired payload fields
generic-tricredit-summary-bvnTriCredit summary by BVNbvn
generic-crc-bvnCRC credit report by BVNbvn
generic-kenya-crbKenya Credit Reference Bureauid_number
generic-national-id-keKenya National IDid_number

Request example

TriCredit summary:
curl -X POST "https://api-dev.usenumero.com/numeroaccount/api/v1/business/verification/generic-tricredit-summary-bvn" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -H "x-signature-key: generated_signature" \
  -d '{
    "payload": {
      "bvn": "12345678901"
    }
  }'

Response

Returns the standard verification response format with normalizedResult containing the credit or identity data.