SprintCheck

Identity verification

Verify BVN

API key

Validates a customer's Bank Verification Number and returns the identity record held against it — names, date of birth, gender and the enrolment photo. Useful for onboarding, fraud prevention and KYC compliance.

POSThttps://api.sprintcheck.megasprintlimited.com.ng/api/v1/bvn

Authorization

Send your secret API key in the Authorization header. Keys are issued per business — find them under Developers in your dashboard.

Authorization: <api_key>

Parameters

Body parameters

  • numberstringrequired

    The customer's 11-digit Bank Verification Number.

    Example: 22454670613

  • identifierstringrequired

    A unique reference for this request in your system.

    Example: samji@email.com

POST /bvn
PAYLOAD='{
  "number": "22454670613",
  "identifier": "samji@email.com"
}'
SIGNATURE=$(printf '%s' "$PAYLOAD" | tr -d '[:space:]' \
  | openssl dgst -sha512 -hmac "$SPRINTCHECK_ENCRYPTION_KEY" \
  | awk '{print $NF}')

curl -X POST "https://api.sprintcheck.megasprintlimited.com.ng/api/v1/bvn" \
  -H "Authorization: $SPRINTCHECK_API_KEY" \
  -H "signature: $SIGNATURE" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d "$PAYLOAD"
Response · 200
{
  "success": 1,
  "message": "Verified Successfully",
  "data": {
    "firstName": "SA*****",
    "lastName": "OD*****",
    "middleName": "AD*****",
    "dateOfBirth": "12-Dec-1996",
    "phoneNumber1": "0816*******",
    "email": null,
    "gender": "Male",
    "stateOfOrigin": "Osun State",
    "bvn": "2245********",
    "nin": null,
    "registrationDate": "2017-11-28",
    "lgaOfOrigin": "Irewole",
    "maritalStatus": "Single",
    "watchListed": "False",
    "base64Image": "/9j/4AAQSkZJRgABAQEAYABgAAD...",
    "nationality": "",
    "phoneNumber2": "",
    "title": "",
    "enrollmentBank": "",
    "enrollmentBranch": "",
    "lgaOfResidence": "",
    "stateOfResidence": "",
    "nameOnCard": "",
    "residentialAddress": "",
    "levelOfAccount": "",
    "number": "2245********"
  }
}

Representative example — field values are illustrative.

Test this endpoint

Simulated run — returns the example payload without calling the live API.

POSThttps://api.sprintcheck.megasprintlimited.com.ng/api/v1/bvn