SME API Logo SME API Docs
Home Get API Key
Live API documentation

Build with SME API endpoints.

Use this live documentation to connect your website, app or reseller platform to SME API services including airtime, data, cable TV, electricity, exam pins, data pins, recharge card printing and more.

View Live Data Plans
POSTPurchase endpoints
GETBalance and plans
TokenAPI authorization
RefUnique request tracking
Important: Use a new unique ref for every paid transaction. Keep your API key private. Test carefully before sending live customer transactions.
AUTH

Authentication

Protected endpoints require your API key in the Authorization header.

Header format 
Authorization: Token your-api-key-here
Content-Type: application/json
GET

Check Balance

Use this endpoint to check the authenticated user profile and wallet balance.

https://smeapi.com.ng/api/user/
cURL request 
curl --location 'https://smeapi.com.ng/api/user/' \
--header 'Authorization: Token your-api-key-here' \
--header 'Content-Type: application/json'
POST

Airtime

Use this endpoint to purchase airtime.

https://smeapi.com.ng/api/airtime/
Sample body 
{
  "network": 1,
  "amount": 100,
  "phone": "08031234567",
  "ref": "AIRTIME-UNIQUE-001",
  "ported_number": "false"
}
cURL request 
curl --location 'https://smeapi.com.ng/api/airtime/' \
--header 'Authorization: Token your-api-key-here' \
--header 'Content-Type: application/json' \
--data '{"network":1,"amount":100,"phone":"08031234567","ref":"AIRTIME-UNIQUE-001"}'
POST

Data Purchase

Use this endpoint to buy data. The data_plan value should come from the live Data Plans section below.

https://smeapi.com.ng/api/data/
Sample request body 
{
  "network": 1,
  "data_plan": 2,
  "phone": "08031234567",
  "ref": "DATA-UNIQUE-001",
  "ported_number": "false"
}
cURL request 
curl --location 'https://smeapi.com.ng/api/data/' \
--header 'Authorization: Token your-api-key-here' \
--header 'Content-Type: application/json' \
--data '{"network":1,"data_plan":2,"phone":"08031234567","ref":"DATA-UNIQUE-001"}'
GET

Live Data Plans

This section fetches current data plans directly from https://smeapi.com.ng/api/dataplans/. Developers should use the plan ID shown here when calling the Data Purchase endpoint.

https://smeapi.com.ng/api/dataplans/
Request 
curl --location 'https://smeapi.com.ng/api/dataplans/' \
--header 'Content-Type: application/json'
Loading plans...
Fetching live data plans...
POST

Cable TV

Verify cable details first, then submit the cable purchase request.

https://smeapi.com.ng/api/cabletv/verify/
https://smeapi.com.ng/api/cabletv/
Sample body 
{
  "provider": 1,
  "iucnumber": "1234567890",
  "phone": "08031234567",
  "plan": 1,
  "ref": "CABLE-UNIQUE-001"
}
POST

Electricity

Verify meter/customer details first, then submit the electricity payment request.

https://smeapi.com.ng/api/electricity/verify/
https://smeapi.com.ng/api/electricity/
Sample body 
{
  "provider": 1,
  "metertype": "prepaid",
  "meternumber": "12345678901",
  "amount": 1000,
  "phone": "08031234567",
  "ref": "ELECTRICITY-UNIQUE-001"
}
POST

Exam Pin

Use this endpoint to purchase exam pins where enabled.

https://smeapi.com.ng/api/exam/
Sample body 
{
  "provider": 1,
  "quantity": 1,
  "ref": "EXAM-UNIQUE-001"
}
POST

Extra Service Endpoints

Additional endpoints available in your existing documentation.

https://smeapi.com.ng/api/datapin/
https://smeapi.com.ng/api/rechargepin/
https://smeapi.com.ng/api/bulksms/
https://smeapi.com.ng/api/smile-data/
https://smeapi.com.ng/api/alphatopup/
https://smeapi.com.ng/api/kirani/
Note 
Use a new, unique ref for every request.
Some extra services require administrator configuration before live transactions can succeed.