API Documentation

Integrate A1Topup services seamlessly into your applications.

Introduction

Welcome to the A1Topup Developer API documentation. This API allows you to programmatically access our VTU services, including Airtime Topup, Data Bundles, Cable TV Subscriptions, and Electricity Bill Payments.

All API requests should be made to the base URL: https://api.a1topup.com/v1

Authentication

Authentication is required for all API requests. You will need an API key, which can be generated from your A1Topup dashboard after upgrading to an Agent or Reseller account.

Include your API key in the request header as follows:

Authorization: Bearer YOUR_API_KEY

Endpoints Overview

Below is a summary of available endpoints. Refer to the detailed documentation for request parameters and response formats.

POST /airtime

Purchase airtime for a specific phone number.

POST /data

Purchase a data bundle for a specific phone number.

GET /data/plans/{network_id}

Retrieve available data plans for a specific network.

POST /cable-tv

Subscribe or renew a Cable TV package.

POST /electricity

Pay for electricity (prepaid token or postpaid bill).

GET /wallet/balance

Check your current wallet balance.

Need More Details?

For comprehensive details, request parameters, response examples, and error codes, please refer to the full documentation.

Or Contact Support for assistance.