Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Compare BVN selfie

/kyc/verify_bvn_comparePOST
Compares a customer selfie with the BVN photo. facial_data lists face matches with a Similarity score from 0 to 100; an empty list means no match. Pick your own threshold (90+ is a common choice). Each call is charged.
Authorization
bearerAuth *Bearer <token>
Your API token from the SendCheap business dashboard.
Request Bodyapplication/jsonrequired
bvn *string
11-digit Bank Verification Number.
Example: "22212345678"Min length: 10
firstname *string
First name to match against the BVN record.
Example: "Adebayo"
lastname *string
Last name to match against the BVN record.
Example: "Oluwaseun"
client_image *string
File name of the selfie already stored in SendCheap storage (_USER_IMAGE folder). Not a base64 image. Contact support to get selfie upload set up for your account.
Example: "selfie_7f3a9c21.jpg"Min length: 10
tranx_id *string
Your unique reference for this request, at least 10 characters. A reference can only be used once; reusing it returns "duplicate transaction detected". Store it so you can verify the transaction later.
Example: "ACME-20261121-000184"Min length: 10
Response
200 · Processed
status *"success" | "failed"
success when the request did what you asked.
message *string
Human-readable result.
data *object
The result. Shape depends on the endpoint; null on most errors.
400 · Missing or invalid field
status *"success" | "failed"
success when the request did what you asked.
message *string
Human-readable result.
data *object
The result. Shape depends on the endpoint; null on most errors.
406 · Missing or invalid API token
status *"success" | "failed"
success when the request did what you asked.
message *string
Human-readable result.
data *object
The result. Shape depends on the endpoint; null on most errors.
417 · Rejected
status *"success" | "failed"
success when the request did what you asked.
message *string
Human-readable result.
data *object
The result. Shape depends on the endpoint; null on most errors.
Request example
curl -X POST "https://api.sendcheap.us/apps/business/kyc/verify_bvn_compare" \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/json" \ -d '{ "bvn": "22212345678", "firstname": "Adebayo", "lastname": "Oluwaseun", "client_image": "selfie_7f3a9c21.jpg", "tranx_id": "ACME-KYC-0000000101" }'
Response example
{ "status": "success", "message": "BVN processed successfully", "data": { "bvn_data": { "id": 3051, "bvn": "22212345678", "bvn_data": { "request_reference": "a1b2c3d4e5", "infoId": 48211, "bvn_number": "22212345678", "name_on_card": "ADEBAYO OLUWASEUN", "enrolment_branch": "IKEJA", "enrolment_bank": "058", "formatted_registration_date": "2014-06-03", "level_of_account": "Level 2 - Medium Level Accounts", "nin": null, "watchlisted": "NO", "verification_status": "VERIFIED", "service_type": "BVN Full Details", "personal_info": { "first_name": "ADEBAYO", "middle_name": "JOHN", "last_name": "OLUWASEUN", "full_name": "ADEBAYO JOHN OLUWASEUN", "email": "adebayo@example.com", "gender": "Male", "phone_number": "08031234567", "phone_number_2": null, "date_of_birth": "12-Apr-1990", "formatted_date_of_birth": "1990-04-12", "lga_of_origin": "Ikeja", "state_of_origin": "Lagos State", "nationality": null, "marital_status": "Single", "image_url": "https://images.example.com/bvn/22212345678.jpg" }, "residential_info": { "state_of_residence": "Lagos State", "lga_of_residence": null, "residential_address": "12 Allen Avenue, Ikeja" } }, "bvn_image": "_BVN/22212345678.jpg", "created_at": "2026-11-21 12:01:33" }, "facial_data": [ { "Similarity": 97.81, "Face": { "Confidence": 99.99, "BoundingBox": { "Width": 0.42, "Height": 0.55, "Left": 0.29, "Top": 0.18 } } } ] } }