Generic Verifications

Most checks have a dedicated endpoint — use those. This generic endpoint is the escape hatch for types that don’t, currently the Kenya verifications.

Looking for credit checks? They have first-class endpoints now — see Credit. You no longer need this endpoint for them.

Endpoint

POST /api/v1/business/verification/{verificationCode}

Signature required: Yes

Path parameters

Parameter	Type	Required	Description
`verificationCode`	string	Yes	The verification type code, lower-case and hyphenated (see below)

The code is the verification type itself — e.g. crb, national-id-ke. Do not prefix it with generic-: the endpoint uppercases the code and swaps - for _, so generic-crc-bvn resolves to GENERIC_CRC_BVN, which is not a real type, and the call fails with UNSUPPORTED.

Request body

Field	Type	Required	Description
`payload`	object	Yes	Key-value pairs specific to the verification type
`idempotencyKey`	string	No	Unique key to prevent duplicate charges

Supported codes

Code	Description	Required payload fields
`crb`	Kenya Credit Reference Bureau	`firstName`, `lastName`, `nationalId`
`national-id-ke`	Kenya National ID	`number`

Request example

Kenya National ID:

curl -X POST "https://api.usenumero.com/numeroaccount/api/v1/business/verification/national-id-ke" \
  -H "Content-Type: application/json" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2" \
  -d '{
    "payload": {
      "number": "12345678"
    }
  }'

Kenya CRB:

curl -X POST "https://api.usenumero.com/numeroaccount/api/v1/business/verification/crb" \
  -H "Content-Type: application/json" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2" \
  -d '{
    "payload": {
      "firstName": "Jane",
      "lastName": "Wanjiru",
      "nationalId": "12345678"
    }
  }'

Response

Returns the standard verification response, with normalizedResult carrying the identity or credit data. Like every other check it is synchronous — the result is in the response.

Getting Started

Transfers & Payouts

Collections (Virtual Accounts)

Wallet-as-a-Service

Customers

Invoices

Cards

Cardholders

Balance & Transactions

Value Added Services

Credit

Verification / KYC

Webhooks

Generic Verifications

Endpoint

Path parameters

Request body

Supported codes

Request example

Response

​Endpoint

​Path parameters

​Request body

​Supported codes

​Request example

​Response

Endpoint

Path parameters

Request body

Supported codes

Request example

Response