NUBAN (BVN Data)

Verify a user's account number for all banks in Nigeria.

This Endpoint will return the the account holder's BVN and the Bio-data associated with the BVN. To conduct a live test

{{baseUrl}}/v1/ng/identities/bvn-nuban

Request Body

Parameters

Type

Description

firstname (REQUIRED)

string

First Name

lastname
(REQUIRED)

string

Last Name

accountNumber
(REQUIRED)

string

Account Number

bankCode
(REQUIRED)

string

Bank Code

dob
(OPTIONAL)

string

Date Of Birth (YYYY-MM-DD)

phone
(OPTIONAL)

string

Phone Number

gender
(OPTIONAL)

string

Gender

Response Sample

{
    "id": 1781,
    "applicant": {
        "accountNumber": "1001111111",
        "bankCode": "000016",
        "firstname": "Bunch",
        "lastname": "Dillon",
        
    },
    "summary": {
        "bvn_nuban_check": {
            "status": "EXACT_MATCH",
            "fieldMatches": {
                "firstname": true,
                "lastname": true,
                
            }
        }
    },
    "status": {
        "state": "complete",
        "status": "verified"
    },
    "bvn_nuban": {
        "firstname": "Bunch",
        "middlename": "Maku",
        "lastname": "Dillon",
        "birthdate": "20-Jun-1893",
        "gender": "Male",
        "phone": "08100000000",
        "bvn": "1001111111",
        "photo": "/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQND
    
    }
}