V1.0.0

API Documentation

Welcome to the Arewa Smart API. Power your business with Nigeria's most reliable identity and utility service gateway.

Base Endpoint

https://www.api.arewasmart.com.ng/api/v1

All requests must be served over HTTPS for security.

Authentication

We use Bearer Token authentication to secure our endpoints. To access any API route, you must include your unique API Token in the Authorization header of your HTTP request.

1. Create Account

2. Login to Dashboard

Access your developer panel.

3. Get API Key

Generate your token in Profile Settings.

Header Authorization Example cURL

curl -X GET "https://www.api.arewasmart.com.ng/api/v1/user" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Security Warning

Never share your API Token publicly. Avoid exposing it in client-side code such as front-end JavaScript components or mobile apps that can be decompiled.

Standardized Responses

Our API returns consistent JSON payloads to make integration predictable and easy to handle across different programming languages.

Success Response (2xx)

{
    "status": true,
    "message": "Operation successful",
    "data": { ... }
}

Error Response (4xx/5xx)

{
    "status": false,
    "message": "The provided token is invalid or expired."
}

Ready to dive in?

Explore our comprehensive API endpoints to start building your solution today.

Explore Documentation