curl --request POST \
--url https://api.vtulab.com/v1/identity/nin/verify \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
"nin": "12345678901",
"is_consent": true,
"mode": "basic"
}'
{
"status": true,
"message": "NIN Verified Successfully",
"data": {
"transaction": {
"title": "NIN Verification",
"amount": 100,
"reference": "VERIFY_65E8F...",
"status": "success"
},
"result": {
"first_name": "JOHN",
"last_name": "DOE",
"middle_name": "JAMES",
"gender": "M",
"date_of_birth": "1990-01-01"
}
}
}
Identity Services
NIN Verification
Securely verify National Identification Numbers in real-time.
POST
/
identity
/
nin
/
verify
curl --request POST \
--url https://api.vtulab.com/v1/identity/nin/verify \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
"nin": "12345678901",
"is_consent": true,
"mode": "basic"
}'
{
"status": true,
"message": "NIN Verified Successfully",
"data": {
"transaction": {
"title": "NIN Verification",
"amount": 100,
"reference": "VERIFY_65E8F...",
"status": "success"
},
"result": {
"first_name": "JOHN",
"last_name": "DOE",
"middle_name": "JAMES",
"gender": "M",
"date_of_birth": "1990-01-01"
}
}
}
Verify the identity of individuals using their National Identification Number (NIN). Our API provides access to verified records from the NIMC database.
Consent Required: You must obtain explicit consent from the individual before verifying their NIN. Requests without
is_consent: true will be rejected.Verification Modes
We offer two modes of verification to suit your needs:- Basic: Returns essential information (Full Name, Gender, Date of Birth).
- Advanced: Returns comprehensive details including the individual’s photo (Base64).
curl --request POST \
--url https://api.vtulab.com/v1/identity/nin/verify \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
"nin": "12345678901",
"is_consent": true,
"mode": "basic"
}'
{
"status": true,
"message": "NIN Verified Successfully",
"data": {
"transaction": {
"title": "NIN Verification",
"amount": 100,
"reference": "VERIFY_65E8F...",
"status": "success"
},
"result": {
"first_name": "JOHN",
"last_name": "DOE",
"middle_name": "JAMES",
"gender": "M",
"date_of_birth": "1990-01-01"
}
}
}