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/validatenin/Validate NIN
POST — verify NIN against registered full name
api:readChecks that an 11-digit NIN matches the account holder's registered full name. Uses the same EaseID / Monnify switch from web config. 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/validatenin/Parameters / payload fields
| Field | Type | Required | Description |
|---|---|---|---|
| nin | string | Yes | 11-digit NIN (or use `number`) |
| number | string | Alt | Same as nin |
Code samples
cURL
curl -X POST "https://datavendor.ng/api/validatenin/" \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"nin":"12345678901"}'Request body (JSON)
JSON
{
"nin": "12345678901"
}Response sample (200)
JSON
{
"valid": true,
"provider": "monnify",
"provider_label": "Monnify",
"nin": "12345678901",
"first_name": "JOHN",
"last_name": "DOE",
"middle_name": ""
}To upgrade KYC to Tier 2 (requires NIN slip upload), call POST /api/kyc/tier2/nin/.