dataapps merchant API
API Documentation
REST API for data, airtime, cable TV, electricity and exam pins. Authenticate with your token and call the live base URL below.
Base URL
https://dataapps.com.ngAPI Reference
Authentication, headers & getting started
Full REST API for airtime, data, cable TV, electricity, exam pins, recharge cards, bulk SMS and wallet queries. Your account must be set to API user type before documentation and token access are enabled.
Service availability
See which API products are covered in this documentation.
Need a product enabled for your API user? Contact support from Account settings or your admin panel.
- Available
Wallet & user profile
Balance, account type, and identity fields for the authenticated API user.
GET /api/user/
- Available
Data plans & purchase
List networks/plans and buy SME, gifting, CG, awoof, and data share bundles.
GET /api/get/network/ · POST /api/data/
- Available
Airtime top-up
VTU and share-and-sell airtime with wallet debit.
POST /api/topup/
- Available
Cable TV
Validate IUC then subscribe GOTV, DSTV, and Startimes packages.
POST /api/cablesub/
- Available
Electricity
Validate meter and vend prepaid/postpaid tokens.
POST /api/billpayment/
- Available
Exam pins & recharge cards
WAEC/NECO/NABTEB result checker pins and printable recharge card orders.
POST /api/epin/ · GET /api/epin/{id}/ · POST /api/rechargepin/
- Available
Bulk SMS
Send SMS campaigns from your wallet balance and list past batches.
POST /api/sendsms/ · GET /api/sms/
- Available
Identity validation
BVN and NIN checks via configured provider (EaseID / Monnify).
Validate BVN · Validate NIN
Step 1 — Obtain your API token
Go to Dashboard → API access → enter your 5-digit transaction PIN → View token. Keep this secret. Reset it from the same page if compromised.
Step 2 — Required headers on every call
Send `Authorization: Token <your_token>` on all endpoints. For POST requests also send `Content-Type: application/json`.
Step 3 — Validate before you buy
Use Validate IUC / Validate Meter before cable or electricity. Use Validate BVN / Validate NIN for identity checks (provider is set in admin web config: EaseID or Monnify — no date of birth required).
Step 4 — Query transaction status
After purchase, query by transaction ID or `ident` reference using the Query endpoints below.
Required headers
| Header | Value | Required |
|---|---|---|
| Authorization | Token YOUR_API_TOKEN | Yes |
| Content-Type | application/json | Yes (POST/PUT) |
| Accept | application/json | Recommended |
Endpoint
https://dataapps.com.ng/api/user/Code samples
curl -X GET "https://dataapps.com.ng/api/user/" \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Accept: application/json"Response sample (200)
{
"username": "testuser",
"FullName": "Test User",
"Account_Balance": "435711.00",
"user_type": "API",
"Phone": "08012345678",
"email": "user@example.com"
}