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

Match BVN name

/kyc/verify_bvn_boolPOST
Checks that the first and last name match the BVN record. On a match it returns the stored record; note that bvn_data here is a JSON string, so decode it. 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"
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 · Names match
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_bool" \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/json" \ -d '{ "bvn": "22212345678", "firstname": "Adebayo", "lastname": "Oluwaseun", "tranx_id": "ACME-KYC-0000000101" }'
Response example
{ "status": "success", "message": "name matching was successful", "data": { "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\"}}", "id": 3051, "bvn": "22212345678", "bvn_image": "_BVN/22212345678.jpg", "created_at": "2026-11-21 12:01:33" } }