Skip to main content
View past verifications and retrieve detailed results.

​
List Verification History

Retrieve a paginated list of all verification requests. 
GET /api/v1/business/verification/history
Signature required: No

​
Headers

HeaderRequiredDescription
x-api-keyYesYour API key

​
Query parameters

ParameterTypeRequiredDefaultDescription
pageNumberintegerNo1Page number
pageSizeintegerNo20Records per page
verificationTypestringNo—Filter by type (e.g., bvn, nin, cac-basic)
statusstringNo—Filter by status
startDatedatetimeNo—Filter from date
endDatedatetimeNo—Filter to date

​
Request example

curl -X GET "https://api-dev.usenumero.com/numeroaccount/api/v1/business/verification/history?pageNumber=1&pageSize=20&verificationType=bvn" \
  -H "x-api-key: your_api_key"

​
Response

{
  "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.00
      }
    ],
    "totalCount": 50,
    "pageNumber": 1,
    "pageSize": 20
  }
}

​
Get Verification by ID

Retrieve the full details and result of a specific verification. 
GET /api/v1/business/verification/{id}
Signature required: No

​
Path parameters

ParameterTypeRequiredDescription
idintegerYesThe verification ID

​
Request example

curl -X GET "https://api-dev.usenumero.com/numeroaccount/api/v1/business/verification/12345" \
  -H "x-api-key: your_api_key"

​
Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "data": {
    "verificationId": 12345,
    "reference": "VER-abc123",
    "type": "bvn",
    "status": "Successful",
    "createdAt": "2024-01-15T10:30:00Z",
    "normalizedResult": {
      "firstName": "John",
      "lastName": "Doe",
      "dateOfBirth": "1990-05-15",
      "phoneNumber": "08012345678",
      "gender": "Male"
    },
    "walletTransaction": {
      "reference": "TRX-abc123",
      "amount": 100.00,
      "date": "2024-01-15T10:30:00Z",
      "status": "Successful"
    }
  }
}