API Docs

API Documentation

Complete guide to integrating with our VTU and bill payment APIs.

Overview

Our REST API allows you to integrate VTU services such as airtime top-up, data bundles, cable TV subscriptions, electricity bill payments, and more into your application. All endpoints return JSON responses and use standard HTTP status codes.

Authentication

All API requests require authentication using your API key and secret key. Include these credentials in the request headers:

Content-Type: application/json
api-key: your-api-key
secret-key: your-secret-key

You can generate your API keys from the Generate API Keys page in your dashboard.

Response Codes

CodeMeaning
200Success — request processed. Check the response body for the actual transaction status.
400Bad Request
401Unauthorized
404Not Found
500Internal Server Error

Quickstart Example

Here is a minimal example of purchasing airtime using cURL:

curl -X POST https://domain.com/api/airtimeapi \
  -H "Content-Type: application/json" \
  -H "api-key: your-api-key" \
  -H "secret-key: your-secret-key" \
  -d '{
    "phone": "08032566178",
    "firstLevel": "MTN VTU",
    "amount": 100,
    "requestId": "yourreference"
  }'

Available Endpoints

Use the sidebar to browse detailed documentation for each endpoint.

IABCONCEPT