Verify BVN (advanced — full record + photo)

curl --request POST \
  --url https://api-staging.usenumero.com/numeroaccount/api/v1/business/verification/bvn-advanced \
  --header 'Content-Type: application/json' \
  --header 'X-Numero-Api-Key: <api-key>' \
  --data '
{
  "bvn": "<string>",
  "idempotencyKey": "<string>"
}
'

{
  "data": {
    "id": 123,
    "status": "Completed",
    "verificationType": "<string>",
    "fee": "<string>",
    "feeCurrency": "<string>"
  },
  "error": {
    "message": "<string>",
    "param": "<string>"
  },
  "meta": {
    "request_id": "<string>",
    "pagination": {
      "page": 123,
      "page_size": 123,
      "total": 123,
      "has_more": true
    }
  }
}

POST

business

verification

bvn-advanced

Verify BVN (advanced — full record + photo)

curl --request POST \
  --url https://api-staging.usenumero.com/numeroaccount/api/v1/business/verification/bvn-advanced \
  --header 'Content-Type: application/json' \
  --header 'X-Numero-Api-Key: <api-key>' \
  --data '
{
  "bvn": "<string>",
  "idempotencyKey": "<string>"
}
'

{
  "data": {
    "id": 123,
    "status": "Completed",
    "verificationType": "<string>",
    "fee": "<string>",
    "feeCurrency": "<string>"
  },
  "error": {
    "message": "<string>",
    "param": "<string>"
  },
  "meta": {
    "request_id": "<string>",
    "pagination": {
      "page": 123,
      "page_size": 123,
      "total": 123,
      "has_more": true
    }
  }
}

Authorizations

X-Numero-Api-Key

string

header

required

Your business API key (live_key_...). Issued on approval; managed in Dashboard → Settings → Developer.

Body

application/json

bvn

string

required

idempotencyKey

string | null

Optional — makes retries safe.

Response

Verification result

Canonical response envelope for the public surface. data on success, error on failure.

data

object

required

Shape varies by product; common fields shown.

Show child attributes

error

object

required

Show child attributes