datavendor.ng merchant API
API Documentation
REST API for data, airtime, cable TV, electricity, exam pins, recharge cards and bulk SMS. Authenticate with your token and call the live base URL below.
JSON over HTTPSToken authenticationLive pricing
Base URL
https://datavendor.ngPOST
/api/validatebvn/Validate BVN
POST — verify BVN against registered full name
api:readChecks that an 11-digit BVN matches the account holder's registered full name. Active provider (EaseID or Monnify) is controlled in Website Configuration → KYC validation provider. No date of birth is required.
Required headers
| Header | Value | Required |
|---|---|---|
| Authorization | Token YOUR_API_TOKEN | Yes |
| Content-Type | application/json | Yes (POST/PUT) |
| Accept | application/json | Recommended |
Endpoint
POST
https://datavendor.ng/api/validatebvn/Parameters / payload fields
| Field | Type | Required | Description |
|---|---|---|---|
| bvn | string | Yes | 11-digit BVN (or use `number`) |
| number | string | Alt | Same as bvn |
Code samples
cURL
curl -X POST "https://datavendor.ng/api/validatebvn/" \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"bvn":"22123456789"}'Request body (JSON)
JSON
{
"bvn": "22123456789"
}Response sample (200)
JSON
{
"valid": true,
"provider": "easeid",
"provider_label": "EaseID",
"bvn": "22123456789",
"first_name": "JOHN",
"last_name": "DOE",
"middle_name": ""
}To upgrade KYC to Tier 1 after validation, call POST /api/kyc/tier1/bvn/ with the same BVN.