BVN Lookup

post https://sandbox-api.oneliquidity.technology/compliance/v1/gov/ng/bvn

Use this endpoint to lookup BVN details from the Government's database

Sample request body

{
    "bvn":"24444896000",
    "firstName": "John",
    "lastName": "Ciroma",
    "verificationId": "c61060e9-635a-5392-b39d-b1c27479d67c"
}

Response Sample

The result of this endpoint is sent to the integrator's webhook URL. An example response is given below:

{
  "event": "COMPLIANCE_BVN_EVENT",
  "message": "Ok",
  "data": {
    "id": "c61060e9-635a-5392-b39d-b1c27479d67c",
    "status": "completed",
    "bvn": "11122295000",
    "firstName": "Chukwuma",
    "lastName": "Ciroma",
    "middleName": "Adekunle",
    "gender": "Male",
    "phone": "07033239193",
    "dateOfBirth": "11-08-2000"
  },
  "checksum": "f7d90758d2fc4613e02b990f0f60464edd211ab7236377d2defdef21c9748afd"
}