Verification / KYC
Verification History
View past verifications and retrieve detailed results.
View past verifications and retrieve detailed results.
Signature required: No
Signature required: No
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
View past verifications and retrieve detailed results.
GET /api/v1/business/verification/history
| Header | Required | Description |
|---|---|---|
X-Numero-Api-Key | Yes | Your API key |
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageNumber | integer | No | 1 | Page number |
pageSize | integer | No | 20 | Records per page |
verificationType | string | No | — | Filter by type (e.g., bvn, nin, cac-basic) |
status | string | No | — | Filter by status |
startDate | datetime | No | — | Filter from date |
endDate | datetime | No | — | Filter to date |
curl -X GET "https://api.usenumero.com/numeroaccount/api/v1/business/verification/history?pageNumber=1&pageSize=20&verificationType=bvn" \
-H "X-Numero-Api-Key: your_api_key"
{
"data": [
{
"verificationId": 12345,
"reference": "VER-abc123",
"type": "bvn",
"status": "Successful",
"createdAt": "2024-01-15T10:30:00Z",
"maskedIdentifiers": "123****8901",
"walletTransactionReference": "TRX-abc123",
"walletAmount": 100.0
}
],
"error": null,
"meta": {
"request_id": "req_365123ebc73323f1482508560ce6400e",
"pagination": {
"page": 1,
"page_size": 20,
"total": 50,
"has_more": true
}
}
}
GET /api/v1/business/verification/{id}
| Parameter | Type | Required | Description |
|---|---|---|---|
id | integer | Yes | The verification ID |
curl -X GET "https://api.usenumero.com/numeroaccount/api/v1/business/verification/12345" \
-H "X-Numero-Api-Key: your_api_key"
{
"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.0,
"date": "2024-01-15T10:30:00Z",
"status": "Successful"
}
},
"error": null,
"meta": {
"request_id": "req_365123ebc73323f1482508560ce6400e",
"pagination": null
}
}