List verification history

curl --request GET \
  --url https://api-staging.usenumero.com/numeroaccount/api/v1/business/verification/history \
  --header 'X-Numero-Api-Key: <api-key>'

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "data": {
    "items": [
      {
        "verificationId": 12345,
        "reference": "VER-abc123",
        "type": "bvn",
        "status": "Successful",
        "createdAt": "2024-01-15T10:30:00Z",
        "maskedIdentifiers": "123****8901",
        "walletTransactionReference": "TRX-abc123",
        "walletAmount": 100
      }
    ],
    "totalCount": 50,
    "pageNumber": 1,
    "pageSize": 20
  }
}

GET

business

verification

history

List verification history

curl --request GET \
  --url https://api-staging.usenumero.com/numeroaccount/api/v1/business/verification/history \
  --header 'X-Numero-Api-Key: <api-key>'

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "data": {
    "items": [
      {
        "verificationId": 12345,
        "reference": "VER-abc123",
        "type": "bvn",
        "status": "Successful",
        "createdAt": "2024-01-15T10:30:00Z",
        "maskedIdentifiers": "123****8901",
        "walletTransactionReference": "TRX-abc123",
        "walletAmount": 100
      }
    ],
    "totalCount": 50,
    "pageNumber": 1,
    "pageSize": 20
  }
}

Authorizations

X-Numero-Api-Key

string

header

required

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

Query Parameters

startDate

string<date-time>

endDate

string<date-time>

type

string

pageNumber

integer

default:1

Required range: x >= 1

pageSize

integer

default:50

Required range: 1 <= x <= 200

Response

Successful response

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

data

any

required

Endpoint payload on success (object or array); null on failure.

error

object

required

Show child attributes