Skip to main content

​
Overview

Our Vending API allows you to purchase airtime and data bundles for mobile networks. Currently, we support Nigeria with airtime and data 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

​
Supported Networks

MTN

Nigeria’s largest mobile network

Airtel

Major Nigerian mobile network

Globacom (Glo)

Leading Nigerian mobile network

9mobile

Nigerian mobile network

​
Getting Started

1

List Available Networks

Get all supported airtime networks and their details
GET /airtimeList
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

View Statistics

Monitor your vending performance and account balance
GET /statistics
6

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