IDENTITY VERIFICATION

BVN Verification

The BVN endpoint enables you to verify the identity of users via their 11-digit Bank Verification Number linked to their bank accounts.

POST /api/v1/bvn

Authentication & Headers

HEADER	VALUE	REQUIRED
`Authorization`	`Bearer YOUR_API_TOKEN`	Yes

Request Parameters

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`bvn`	string	The 11-digit Bank Verification Number.	Required

Example Request

cURL

curl -X POST "https://www.api.arewasmart.com.ng/api/v1/bvn" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -d "bvn=01234567890"

Success Response (200 OK)

{
    "status": true,
    "message": "BVN Verified Successfully",
    "data": {
        "firstName": "John",
        "lastName": "Doe",
        "middleName": "Smith",
        "dateOfBirth": "01-Jan-1990",
        "phoneNumber": "08012345678"
    }
}