BVN Verification Status (Admin Only)

Fetch the latest status and identity result of a previous BVN verification using the provider reference. Used for manual reconciliation of pending, ambiguous or disputed results. Access restricted to system administrators.

GET/v1/bvn/status/{reference}

Authorization

x-api-key<token>

In: header

Path Parameters

reference*string

The provider internal reference (providerReference) returned in the initial lookup.

Header Parameters

X-Correlation-ID?string

Response Body

`application/json`

curl -X GET "https://example.com/v1/bvn/status/775b2138-cbf5-4199-98a4-b5bd306718c6"

{  "success": true,  "statusCode": 200,  "message": "Request processed successfully",  "timestamp": "2025-10-20T16:30:00.000Z",  "path": "/v1/auth/register",  "data": {    "verificationData": {},    "verificationStatus": "VERIFIED",    "provider": "PREMBLY",    "providerEndpoint": "BVN_BASIC",    "providerResponseCode": "00",    "referenceId": "bvn_ref_12345",    "providerReference": "...reference..."  }}

Empty