BVN

POST

/api/v{{apiVersion}}/business/verification/bvn

Bank Verification Number (basic). Body: bvn (required), idempotencyKey (optional).

Request

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://api-dev.usenumero.com/numeroaccount/api/v{{apiVersion}}/business/verification/bvn' \
--header '{{apiHeaderName}}: {{apiKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "bvn": "12345678901",
  "idempotencyKey": "optional-unique-key"
}'

Response Example

{
  "status": true,
  "message": "Success",
  "code": "200",
  "version": "v1",
  "reference": "N202601021200001234",
  "data": {
    "verificationRequestId": 1,
    "reference": "VER-20260102-abc",
    "success": true,
    "statusCode": "200",
    "statusMessage": "Success",
    "normalizedResult": { "firstName": "J***" },
    "walletTransactionReference": "VER-20260102-abc",
    "walletAmount": 100.0
  },
  "error": null
}

Modified at 2026-04-03 18:23:15

Verification — POST (signed)

NIN