Verify NIN

POST

/api/v1/public/verifynin

Verifies a National Identification Number against the identity provider. firstName, lastName, and dob are optional — when supplied the provider returns field-level validation matches. Deducts VerifyNINCostPerCall from wallet.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Verification result.

Body

🟠401

🔴502

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v1/public/verifynin' \
--header 'Content-Type: application/json' \
--data-raw '{
    "nin": "12345678901",
    "userConsent": true,
    "firstName": "Chukwuemeka",
    "lastName": "Obiora",
    "dob": "1990-05-15"
}'

Response Example

200 - Example 1

{
    "isVerified": true,
    "message": "Verification successful",
    "data": {
        "reference": "VR-jmJuvnt6imoznOOtN",
        "id": "55555555555",
        "idType": "ng_nin",
        "firstName": "Bimbo",
        "lastName": "Olakunle",
        "middleName": "Doherty",
        "dateOfBirth": "1988-04-04",
        "phoneNumber": "08000000000",
        "address": {
            "town": "SULEJA",
            "lga": "Suleja",
            "state": "Niger",
            "street": "13B Sample Street, Ilupeju Niger State"
        },
        "email": "vino@examplemail.com",
        "birthState": "Edo",
        "birthLga": "Esan West",
        "birthCountry": "nigeria",
        "nextOfKinState": "Niger",
        "religion": "christianity",
        "gender": "female",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ",
        "signature": "data:image/jpg;base64,/9j/4AAQSkZJRgABAQAAAQ",
        "validation": {
            "firstName": {
                "value": "Viola",
                "match": false
            },
            "lastName": {
                "value": "Viola",
                "match": false
            },
            "dateOfBirth": {
                "value": "Viola",
                "match": false
            }
        },
        "requestedBy": "API User"
    }
}

Modified at 2026-04-23 19:30:16

Verify BVN

Check Wallet Balance