The Unified Identity & Utility API Built for High-Growth Businesses
Power your fintech application, agency portal, or digital platform with instant National Identity Number (NIN), Bank Verification Number (BVN), and Tax ID (TIN) verifications, alongside automated Airtime, SME Data, DISCO Electricity Tokens, Cable TV, and Exam PINs.
Global Base Endpoint
Production & SandboxAll requests must be made over secure HTTPS. Include your unique Bearer Token in the authorization header.
https://www.api.arewasmart.com.ng/api/v1
Explore API Services
Select a category to view endpoint references, parameters, and live code examples.
NIN Services
Direct connection to National Identity Management Commission (NIMC) data. Full identity resolution, phone number search, agent validation, modification tracking, and IPE clearance.
BVN Services
High-speed NIBSS Bank Verification Number resolution. Verify customer full names, date of birth, photo enrollment, CRM dispute tracking, and reverse phone lookup.
Verifications of Identity
Verify individual and corporate Tax Identification Numbers (TIN) via FIRS & Joint Tax Board (JTB). Ensure KYC Level-3 compliance and mitigate business onboarding fraud.
Utility Bills & VTU
Automated fulfillment for Airtime (MTN, Airtel, Glo, 9mobile), cheap SME Data bundles, 11 Nigerian electricity DISCOs tokens, Cable TV activation, and Examination PINs.
Get Started in 3 Simple Steps
You can complete full API integration and trigger your first live request in under three minutes.
Fund Developer Wallet
Transfer to your dedicated virtual account (Moniepoint, Wema, Sterling) with zero minimum balance.
Instant Automated CreditGenerate API Key
Copy your Bearer API token from your dashboard settings and start issuing live requests.
Dashboard Login →Interactive Request Example
Sample request to verify a National Identity Number (NIN).
curl -X POST "https://www.api.arewasmart.com.ng/api/v1/nin/verify" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"nin": "12345678901"
}'const response = await fetch("https://www.api.arewasmart.com.ng/api/v1/nin/verify", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_TOKEN",
"Content-Type": "application/json",
"Accept": "application/json"
},
body: JSON.stringify({
nin: "12345678901"
})
});
const data = await response.json();
console.log(data);use Illuminate\Support\Facades\Http;
$response = Http::withToken('YOUR_API_TOKEN')
->acceptJson()
->post('https://www.api.arewasmart.com.ng/api/v1/nin/verify', [
'nin' => '12345678901',
]);
if ($response->successful()) {
$data = $response->json();
}import requests
url = "https://www.api.arewasmart.com.ng/api/v1/nin/verify"
headers = {
"Authorization": "Bearer YOUR_API_TOKEN",
"Content-Type": "application/json",
"Accept": "application/json"
}
payload = {
"nin": "12345678901"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json()){
"status": true,
"message": "NIN verification successful",
"data": {
"nin": "12345678901",
"firstname": "IBRAHIM",
"surname": "MUSA",
"middlename": "BELLO",
"gender": "m",
"birthdate": "1995-04-12",
"phone": "08012345678",
"state": "Kano"
}
}Enterprise Reliability for Modern Products
Designed by Nigerian engineers for businesses that cannot afford transaction downtime.
Multi-Route Failover
Our gateway automatically switches upstream providers in milliseconds if any telecommunications or agency node experiences latency.
Instant Automated Refunds
Never lose a single Naira to failed downstream provider queries. Your developer balance is instantly credited back in real time.
Lowest Wholesale Rates
Get the best margins on SME data, electricity bill commissions, and bulk identity KYC lookups in Nigeria.
Real-Time Webhooks
Receive event-driven notifications for cable TV activations, electricity token generations, and CRM resolutions with HMAC SHA-256 verification.
Bank-Grade Security
TLS 1.3 enforced, IP whitelisting capabilities, rate-limiting protection, and encrypted token storage.
24/7 Developer Community
Talk directly with our integration engineers on WhatsApp for quick debugging, route updates, and customized volume discounts.
Standardized Response Architecture
Every API endpoint returns a predictable JSON payload to simplify your error handling and parsing logic.
{
"status": true,
"message": "Operation completed successfully",
"data": {
"reference": "REF_1234567890",
"amount": 1000
}
}{
"status": false,
"message": "The specified National Identity Number was not found."
}| STATUS CODE | MEANING | DESCRIPTION |
|---|---|---|
| 200 OK | Success | Request fulfilled successfully. Result is available in the data field. |
| 400 Bad Request | Client Error | Missing parameters or malformed JSON payload. |
| 401 Unauthorized | Invalid API Token | The provided Bearer token is missing, expired, or invalid. |
| 422 Unprocessable | Validation Error | Input failed validation rules (e.g., NIN must be exactly 11 digits). |
| 500 Server Error | Upstream Issue | Temporary upstream switch failure. Automatically retried or refunded. |
Ready to Scale Your Applications with Arewa Smart?
Join over 1,500+ businesses, fintech startups, and agents powering their infrastructure with Nigeria's most reliable, low-latency API gateway.