Basic BVN Verification

This service allows you to validate and measure how closely the provided user details (such as name, gender, phone number, and date of birth) match against a given BVN.

Verify Basic BVN

POST https://devapi.idcheck.ng/v1/rest-api/verification/bvn/basic

Headers

Name	Type	Description
apiKey*	API Key

Request Body

Parameter	Type	Required	Description
bvn	String	true	BVN number
firstName	String	true	First name of the user.
middleName	String	false	Middle name of the user.
lastName	String	true	Last name of the user.
gender	String	false	Gender ("male" or "female").
birthday	String	false	Date of Birth in yyyy-MM-dd format.
phoneNumber	String	false	Phone number.

Response Body

200: OK

{
    "success": true,
    "message": "Request successful",
    "data": {
        "nameMatchRlt": "Exact Match",
        "namesMatchPercentage": 100,
        "birthdayMatchRlt": "Exact Match",
        "genderMatchRlt": "Exact Match",
        "phoneNumberMatchRlt": "Exact Match",
        "verificationId": "idcheck-***"
    }
}

404: Not Found

The service responds with a JSON object containing field match results.

Parameter	Type	Description
nameMatchRlt	String	Name matching result: Exactly Match, Partial Match, No Match.
namesMatchPercentage	String	Percentage score for name similarity.
birthdayMatchRlt	String	DoB result: Exactly Match, No Match.
genderMatchRlt	String	Gender result: Exactly Match, No Match.
phoneNumberMatchRlt	String	Phone number result: Exactly Match, No Match.

Matching Logic

• Name Matching

  • Exactly Match → Score: 100

  • Partial Match → Score: between 70 and 99

  • No Match → Score: below 70

• Other Fields Results are binary:

  • Exactly Match → Values are identical

  • No Match → Values differ