Skip to main content

​
Overview

Our Vending API allows you to purchase airtime, data bundles, electricity, and cable TV subscriptions. Currently, we support Nigeria for all vending services, with Kenya support coming soon.

​
Supported Services

Airtime Vending

  • Purchase airtime for all major Nigerian networks
  • Real-time airtime top-up
  • Instant delivery to recipient phone numbers

Data Vending

  • Purchase data bundles for all major Nigerian networks
  • Various data plans with different validity periods
  • Flexible data amounts and durations

Electricity Vending

  • Purchase electricity tokens for all DisCos
  • Pre-validate meter details before purchase
  • Receive 20-digit recharge tokens instantly

Cable TV Vending

  • Subscribe to DSTV, GOTV, and Startimes
  • Validate smartcards before transaction
  • Instant subscription activation

​
Supported Networks & Providers

Telecoms

MTN, Airtel, Globacom (Glo), 9mobile

Electricity DisCos

Ikeja Electric, Eko Electric, Abuja Electric, and more

Cable TV

DSTV, GOTV, Startimes

​
Getting Started

1

List Available Providers

Get all supported airtime networks, electricity DisCos, and cable TV providers
GET /AirtimeList
GET /ElectricityList
GET /CableTVList
2

Purchase Airtime

Buy airtime for any phone number on supported networks
POST /purchaseAirtime
3

List Data Plans

Browse available data bundles by network
GET /dataList?network=mtn
4

Purchase Data

Buy data bundles for any phone number
POST /purchaseData
5

Validate Meter or Smartcard

Verify electricity meter or cable TV smartcard ownership
POST /validateMeter
POST /validateSmartcard
6

Purchase Utilities

Pay for electricity or cable TV
POST /purchaseElectricity
POST /purchaseCableTV
7

View Statistics

Monitor your vending performance and account balance
GET /statistics
8

Check Logs

Review transaction history and status
GET /logEntries

​
Authentication

All vending endpoints require authentication using your API key. Include your API key in the Authorization header.
Authorization: Bearer YOUR_API_KEY

​
Base URL

All vending endpoints are available at the following base URL:
https://api.bleeprs.com/api

​
Response Format

All vending endpoints return responses in a consistent JSON format:
{
  "gatewayStatus": "00",
  "gatewayMessage": "Successfully Processed",
  "requestReference": "UNIQUE_REFERENCE_ID",
  "data": "Response data or message"
}
  • gatewayStatus: “00” indicates success, other values indicate errors
  • gatewayMessage: Human-readable status message
  • requestReference: Unique identifier for tracking the request
  • data: Contains the actual response data or status message