Buy Bulk Airtime API
List bulk requests
Your bulk airtime requests, newest first (without the per-recipient list).
Send your secret key in the
P-API-KEY header. Keep it on your server, never in an app or browser.Query parameters
-
status string Optional
queued, processing, completed, cancelled
Example:completed -
reference string Optional
your request reference
Example:PAYROLL-OCT -
per_page string Required
max 50
Example:20 -
page string RequiredExample:
1
Responses
- 200Success
Request
curl --request GET \ --url 'https://api.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1' \ --header 'Accept: application/json' \ --header 'P-API-KEY: YOUR_SECRET_KEY'curl --request GET \ --url 'https://api.sandbox.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1' \ --header 'Accept: application/json' \ --header 'P-API-KEY: YOUR_SECRET_KEY'
<?php use Illuminate\Support\Facades\Http; $response = Http::withHeaders([ 'Accept' => 'application/json', 'P-API-KEY' => 'YOUR_SECRET_KEY', ])->get('https://api.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1'); $data = $response->json();<?php use Illuminate\Support\Facades\Http; $response = Http::withHeaders([ 'Accept' => 'application/json', 'P-API-KEY' => 'YOUR_SECRET_KEY', ])->get('https://api.sandbox.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1'); $data = $response->json();
const response = await fetch('https://api.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1', { method: 'GET', headers: { "Accept": "application/json", "P-API-KEY": "YOUR_SECRET_KEY", }, }); const data = await response.json();const response = await fetch('https://api.sandbox.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1', { method: 'GET', headers: { "Accept": "application/json", "P-API-KEY": "YOUR_SECRET_KEY", }, }); const data = await response.json();
import requests response = requests.request( "GET", "https://api.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1", headers={ "Accept": "application/json", "P-API-KEY": "YOUR_SECRET_KEY", }, ) data = response.json()import requests response = requests.request( "GET", "https://api.sandbox.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1", headers={ "Accept": "application/json", "P-API-KEY": "YOUR_SECRET_KEY", }, ) data = response.json()
GET /v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1 HTTP/1.1 Host: api.paybeta.ng Accept: application/json P-API-KEY: YOUR_SECRET_KEYGET /v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1 HTTP/1.1 Host: api.sandbox.paybeta.ng Accept: application/json P-API-KEY: YOUR_SECRET_KEY
import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1")) .header("Accept", "application/json") .header("P-API-KEY", "YOUR_SECRET_KEY") .method("GET", HttpRequest.BodyPublishers.noBody()) .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.sandbox.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1")) .header("Accept", "application/json") .header("P-API-KEY", "YOUR_SECRET_KEY") .method("GET", HttpRequest.BodyPublishers.noBody()) .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());
using System.Net.Http; using System.Text; using var client = new HttpClient(); var request = new HttpRequestMessage(new HttpMethod("GET"), "https://api.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1"); request.Headers.TryAddWithoutValidation("Accept", "application/json"); request.Headers.TryAddWithoutValidation("P-API-KEY", "YOUR_SECRET_KEY"); var response = await client.SendAsync(request); var data = await response.Content.ReadAsStringAsync(); Console.WriteLine(data);using System.Net.Http; using System.Text; using var client = new HttpClient(); var request = new HttpRequestMessage(new HttpMethod("GET"), "https://api.sandbox.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1"); request.Headers.TryAddWithoutValidation("Accept", "application/json"); request.Headers.TryAddWithoutValidation("P-API-KEY", "YOUR_SECRET_KEY"); var response = await client.SendAsync(request); var data = await response.Content.ReadAsStringAsync(); Console.WriteLine(data);
package main import ( "fmt" "io" "net/http" ) func main() { req, _ := http.NewRequest("GET", "https://api.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1", nil) req.Header.Set("Accept", "application/json") req.Header.Set("P-API-KEY", "YOUR_SECRET_KEY") res, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer res.Body.Close() data, _ := io.ReadAll(res.Body) fmt.Println(string(data)) }package main import ( "fmt" "io" "net/http" ) func main() { req, _ := http.NewRequest("GET", "https://api.sandbox.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1", nil) req.Header.Set("Accept", "application/json") req.Header.Set("P-API-KEY", "YOUR_SECRET_KEY") res, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer res.Body.Close() data, _ := io.ReadAll(res.Body) fmt.Println(string(data)) }
require "net/http" require "json" uri = URI("https://api.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1") request = Net::HTTP::Get.new(uri) request["Accept"] = "application/json" request["P-API-KEY"] = "YOUR_SECRET_KEY" response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http| http.request(request) end data = JSON.parse(response.body)require "net/http" require "json" uri = URI("https://api.sandbox.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1") request = Net::HTTP::Get.new(uri) request["Accept"] = "application/json" request["P-API-KEY"] = "YOUR_SECRET_KEY" response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http| http.request(request) end data = JSON.parse(response.body)
import okhttp3.MediaType.Companion.toMediaType import okhttp3.OkHttpClient import okhttp3.Request import okhttp3.RequestBody.Companion.toRequestBody val client = OkHttpClient() val request = Request.Builder() .url("https://api.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1") .method("GET", null) .addHeader("Accept", "application/json") .addHeader("P-API-KEY", "YOUR_SECRET_KEY") .build() client.newCall(request).execute().use { response -> println(response.body?.string()) }import okhttp3.MediaType.Companion.toMediaType import okhttp3.OkHttpClient import okhttp3.Request import okhttp3.RequestBody.Companion.toRequestBody val client = OkHttpClient() val request = Request.Builder() .url("https://api.sandbox.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1") .method("GET", null) .addHeader("Accept", "application/json") .addHeader("P-API-KEY", "YOUR_SECRET_KEY") .build() client.newCall(request).execute().use { response -> println(response.body?.string()) }
import Foundation var request = URLRequest(url: URL(string: "https://api.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1")!) request.httpMethod = "GET" request.setValue("application/json", forHTTPHeaderField: "Accept") request.setValue("YOUR_SECRET_KEY", forHTTPHeaderField: "P-API-KEY") let (data, _) = try await URLSession.shared.data(for: request) print(String(data: data, encoding: .utf8)!)import Foundation var request = URLRequest(url: URL(string: "https://api.sandbox.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1")!) request.httpMethod = "GET" request.setValue("application/json", forHTTPHeaderField: "Accept") request.setValue("YOUR_SECRET_KEY", forHTTPHeaderField: "P-API-KEY") let (data, _) = try await URLSession.shared.data(for: request) print(String(data: data, encoding: .utf8)!)
import 'package:http/http.dart' as http; final response = await http.get( Uri.parse('https://api.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1'), headers: { 'Accept': 'application/json', 'P-API-KEY': 'YOUR_SECRET_KEY', }, ); print(response.body);import 'package:http/http.dart' as http; final response = await http.get( Uri.parse('https://api.sandbox.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1'), headers: { 'Accept': 'application/json', 'P-API-KEY': 'YOUR_SECRET_KEY', }, ); print(response.body);
Response
{
"status": "successful",
"message": "Bulk airtime requests retrieved successfully",
"data": [
{
"reference": "PAYROLL-OCT",
"batch_id": "BLK-K3P9XQ2M7Z1A",
"description": "October staff airtime",
"status": "completed",
"total_recipients": 3,
"total_amount": 1700,
"total_charge": 1644,
"amount_charged": 1450,
"summary": {
"successful": 1,
"pending": 1,
"failed": 1,
"queued": 0,
"cancelled": 0
},
"created_at": "2026-10-05T09:00:00+01:00",
"started_at": "2026-10-05T09:00:02+01:00",
"completed_at": "2026-10-05T09:00:14+01:00",
"cancelled_at": null
}
],
"meta": {
"current_page": 1,
"last_page": 1,
"per_page": 20,
"total": 1
}
}