Validate BVN

Endpoint

POST /clients/business/validate-bvn

Headers

string

required

Your public API key.

string

required

Your API secret. Use a stl_test_... value in sandbox, stl_live_... in production.

Request body

string

required

The 11-digit Bank Verification Number to validate.

string

required

The ID of the business this BVN is being validated for.

Response

boolean

true if the BVN was found and validated successfully.

string

Human-readable outcome.

string

Phone number associated with the BVN.

string

The BVN that was validated.

string

First name of the BVN holder.

string

Last name of the BVN holder.

string

Middle or other names of the BVN holder.

string

Date of birth of the BVN holder (format may vary).

Code examples

curl -X POST https://sandbox.stellasbank.com/api/v1/clients/business/validate-bvn \
  -H "x-api-key: stl_c8e286ca55b0123e0b05da047494f585" \
  -H "x-api-secret: stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0" \
  -H "Content-Type: application/json" \
  -d '{
    "bvn": "12345678901",
    "businessId": "YOUR_BUSINESS_ID"
  }'

const res = await fetch(
  "https://sandbox.stellasbank.com/api/v1/clients/business/validate-bvn",
  {
    method: "POST",
    headers: {
      "x-api-key": "stl_c8e286ca55b0123e0b05da047494f585",
      "x-api-secret": "stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ bvn: "12345678901", businessId: "YOUR_BUSINESS_ID" }),
  }
);
const { data } = await res.json();

import requests

res = requests.post(
    "https://sandbox.stellasbank.com/api/v1/clients/business/validate-bvn",
    headers={
        "x-api-key": "stl_c8e286ca55b0123e0b05da047494f585",
        "x-api-secret": "stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0",
    },
    json={"bvn": "12345678901", "businessId": "YOUR_BUSINESS_ID"},
)
print(res.json()["data"])

Example response

{
  "status": true,
  "message": "BVN validated successfully",
  "data": {
    "phoneNumber": "+2348012345678",
    "bvn": "12345678901",
    "firstName": "Ada",
    "lastName": "Lovelace",
    "otherNames": "Grace",
    "dob": "1990-01-01"
  }
}

Overview

Members

Business

Virtual accounts

Funds

Bulk transfers

Disputes

Subscriptions

Payouts

Audit logs

Settings

Endpoint

Headers

Request body

Response

Code examples

Example response

​Endpoint

​Headers

​Request body

​Response

​Code examples

​Example response

Endpoint

Headers

Request body

Response

Code examples

Example response