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