Verification
BVN Verification.
Confirm a Nigerian BVN with real-time NIBSS-registered data — name, phone, date of birth, and match score in under a second.
One request
A single call. Real data.
Copy, paste your test key, and get a real response in seconds.
curl -X POST https://api.karverifi.com/v1/verifications/bvn \
-H "Authorization: Bearer kv_test_xxxx" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"bvn": "12345678901",
"first_name": "Adaeze",
"last_name": "Okoye",
"dob": "1990-04-12"
}'What you get
Everything the compliance team asks for.
Sub-second response
Direct-to-NIBSS pipe with a warm cache — most calls settle in under 900ms.
Name, DOB, phone match
We compare each field you send against the enrolled record and return which matched.
Match-score confidence
A single 0–1 score so your rules engine can auto-approve or route to review.
Consent audit trail
Every check produces a timestamped, downloadable PDF receipt for NDPR compliance.
Response shape
A typical successful response.
{
"id": "ver_01HXK9PZ8VBN9YJT4EXAMPLE",
"type": "bvn",
"outcome": "passed",
"created_at": "2026-07-17T09:12:44Z",
"match_score": 0.98,
"matched_fields": [
"first_name",
"last_name",
"dob"
],
"data": {
"bvn": "12345678901",
"first_name": "Adaeze",
"last_name": "Okoye",
"dob": "1990-04-12",
"phone": "+2348012345678",
"enrolment_bank": "GTBank"
},
"consent": {
"captured_at": "2026-07-17T09:12:40Z",
"receipt_url": "https://receipts.karverifi.com/r/ver_01HXK9PZ8VBN9YJT4EXAMPLE.pdf"
}
}Questions
Common questions on bvn verification.
The BVN itself resolves to a NIBSS-registered identity. We return the enrolled first name, last name, date of birth, phone, and enrolment bank — and score the match against the details you supplied.
Ready to ship?
Wire up bvn verification today.
Test in sandbox for free, go live the same afternoon.