API Documentation & Developer Hub

v2.0 REST Specs

Build high-performance telecom applications, automated VTU stores, and wallet systems using our secure REST endpoints.

Authentication & API Credentials

All requests to api.azabazaar.com must include your Bearer Token in headers.

Your Live Bearer Token

Keep your API key strictly secure. Never expose it in client-side mobile apps or public repositories.

API Endpoints & Code Snippets

Base Gateway: https://api.azabazaar.com

GET /wallet/balance

Fetch real-time available balance from your vault

curl -X GET "https://api.azabazaar.com/wallet/balance" \
     -H "Authorization: Bearer azb_live_e8f7eb6f5430d896fa332a8f5a22077e378e67687833bf9773625a5d7de0e305" \
     -H "Accept: application/json"

<?php
$ch = curl_init('https://api.azabazaar.com/wallet/balance');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer azb_live_e8f7eb6f5430d896fa332a8f5a22077e378e67687833bf9773625a5d7de0e305',
    'Accept: application/json'
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

const res = await fetch('https://api.azabazaar.com/wallet/balance', {
  headers: {
    'Authorization': 'Bearer azb_live_e8f7eb6f5430d896fa332a8f5a22077e378e67687833bf9773625a5d7de0e305',
    'Accept': 'application/json'
  }
});
const data = await res.json();
console.log(data);

POST /vtu/purchase

Instantly vend data bundles or airtime

curl -X POST "https://api.azabazaar.com/vtu/purchase" \
     -H "Authorization: Bearer azb_live_e8f7eb6f5430d896fa332a8f5a22077e378e67687833bf9773625a5d7de0e305" \
     -H "Content-Type: application/json" \
     -d '{
         "service_category": "data",
         "phone": "08031234567",
         "service_id": "7c53ec7d-ad49-11f1-bb13-0200004e9ba4",
         "network_id": 1
     }'

<?php
$ch = curl_init('https://api.azabazaar.com/vtu/purchase');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'service_category' => 'data',
    'phone' => '08031234567',
    'service_id' => '7c53ec7d-ad49-11f1-bb13-0200004e9ba4',
    'network_id' => 1
]));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer azb_live_e8f7eb6f5430d896fa332a8f5a22077e378e67687833bf9773625a5d7de0e305',
    'Content-Type: application/json'
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

const res = await fetch('https://api.azabazaar.com/vtu/purchase', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer azb_live_e8f7eb6f5430d896fa332a8f5a22077e378e67687833bf9773625a5d7de0e305',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    service_category: 'data',
    phone: '08031234567',
    service_id: '7c53ec7d-ad49-11f1-bb13-0200004e9ba4',
    network_id: 1
  })
});
const data = await res.json();
console.log(data);