BVN Match (Boolean)

---

The BVN Boolean Match service enables you to confirm whether a user's first name, last name, date of birth, gender, email, or phone number aligns with the details linked to their Bank Verification Number (BVN). This ensures accurate identity verification and enhances compliance with financial regulations.

To verify BVN Boolean match

Request Body

POST Parameters	Type	Description
bvn (REQUIRED)	string	Bank Verification Number
fistname (REQUIRED)	string	First Name
lastname (REQUIRED)	string	Last Name
dob (OPTIONAL)	dateString	Date Of Birth (YYYY-MM-DD)
phone (OPTIONAL)	string	Phone Number
email (OPTIONAL)	string	Email Address
gender (OPTIONAL)	string	Gender
refresh	boolean	To refresh the CBN database for update data
simulate_success	boolean	If project in sandbox, set to true to simulate success

This endpoint returns Boolean values (true/false) for your selected parameters. To conduct an actual test

Response Sample

{
    "code": 200,
    "message": "Request successful",
    "status": true,
    "data": {
        "verification": {
            "product_id": 1,
            "status": "success",
            "type": "bvn_match",
            "project_id": 1,
            "data": {
                "bvn": "22322090542",
                "firstname": "john",
                "lastname": "doe",
                "phone": null,
                "dob": null,
                "email": null,
                "gender": null,
                "secret_hash": "DmXGPyEv6Lm4gMDD",
                "data": {
                    "fieldMatches": {
                        "firstname": true,
                        "lastname": true
                    }
                }
            },
            "updated_at": "2025-03-25T00:49:20.000000Z",
            "created_at": "2025-03-25T00:49:20.000000Z",
            "id": 1
        }
    }
}