View Statistics
curl --request GET \
--url https://api.bleeprs.com/api/statistics \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.bleeprs.com/api/statistics"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.bleeprs.com/api/statistics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bleeprs.com/api/statistics",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.bleeprs.com/api/statistics"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.bleeprs.com/api/statistics")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bleeprs.com/api/statistics")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"gatewayStatus": "00",
"gatewayMessage": "Successfully Processed",
"requestReference": "ESzHw13F3Xa93uizdop6",
"data": {
"account_balance": {
"amount": "₦7450.00",
"available_for": "vending",
"currency": "NGN",
"last_updated": "9/18/2025, 8:22:50 AM"
},
"period": {
"current_week_start": "2025-09-11",
"current_week_end": "2025-09-18",
"previous_week_start": "2025-09-04",
"previous_week_end": "2025-09-11"
},
"statistics": {
"successful": {
"value": 7,
"rate": "0.0% success rate from last week",
"is_positive": true
},
"failed": {
"value": 17,
"rate": "70.8% failure rate from last week",
"is_positive": false
}
},
"total_amount": {
"value": "₦3850.00",
"change": "0.0% change from last week",
"is_positive": true
},
"total_transactions": {
"value": 24,
"change": "0.0% of total from last week",
"is_positive": true
}
}
}Vending
View Statistics
Get vending statistics and account information
GET
/
statistics
View Statistics
curl --request GET \
--url https://api.bleeprs.com/api/statistics \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.bleeprs.com/api/statistics"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.bleeprs.com/api/statistics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bleeprs.com/api/statistics",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.bleeprs.com/api/statistics"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.bleeprs.com/api/statistics")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bleeprs.com/api/statistics")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"gatewayStatus": "00",
"gatewayMessage": "Successfully Processed",
"requestReference": "ESzHw13F3Xa93uizdop6",
"data": {
"account_balance": {
"amount": "₦7450.00",
"available_for": "vending",
"currency": "NGN",
"last_updated": "9/18/2025, 8:22:50 AM"
},
"period": {
"current_week_start": "2025-09-11",
"current_week_end": "2025-09-18",
"previous_week_start": "2025-09-04",
"previous_week_end": "2025-09-11"
},
"statistics": {
"successful": {
"value": 7,
"rate": "0.0% success rate from last week",
"is_positive": true
},
"failed": {
"value": 17,
"rate": "70.8% failure rate from last week",
"is_positive": false
}
},
"total_amount": {
"value": "₦3850.00",
"change": "0.0% change from last week",
"is_positive": true
},
"total_transactions": {
"value": 24,
"change": "0.0% of total from last week",
"is_positive": true
}
}
}Overview
Retrieve a summary of your vending activity for the past 7 days, alongside the current account balance and week-over-week comparisons.Response Fields
object
object
Date range covered by the current and previous weeks.
object
Transaction metrics for the current 7-day window.
Show statistics
Show statistics
object
Total number of vending transactions this week, with change vs last week.
object
Number of successful transactions this week, with success-rate change vs last week.
object
Number of failed transactions this week, and the failure rate as a percentage.
object
Total amount vended this week (formatted with the Naira symbol), with percentage change vs last week.
number or string
The metric value.
total_amount.value is a formatted string (₦...); others are numbers.string
Percentage change vs the previous week (e.g.
12.5%). Present on total_transactions and total_amount.string
Percentage figure for success or failure rate. Present on
successful and failed.boolean
true when the change or rate represents an improvement (higher volume, higher success rate). Always false for failed.Example Response
{
"gatewayStatus": "00",
"gatewayMessage": "Successfully Processed",
"requestReference": "ESzHw13F3Xa93uizdop6",
"data": {
"account_balance": {
"amount": "₦7450.00",
"available_for": "vending",
"currency": "NGN",
"last_updated": "9/18/2025, 8:22:50 AM"
},
"period": {
"current_week_start": "2025-09-11",
"current_week_end": "2025-09-18",
"previous_week_start": "2025-09-04",
"previous_week_end": "2025-09-11"
},
"statistics": {
"total_transactions": {
"value": 24,
"change": "0.0%",
"is_positive": true
},
"successful": {
"value": 7,
"rate": "0.0%",
"is_positive": true
},
"failed": {
"value": 17,
"rate": "70.8%",
"is_positive": false
},
"total_amount": {
"value": "₦3850.00",
"change": "0.0%",
"is_positive": true
}
}
}
}
Notes
- Statistics cover a rolling 7-day window ending today.
- Monetary amounts are formatted with the Naira symbol (
₦). - Trends compare the current 7-day window to the previous 7-day window.
- Account balance reflects the most recent wallet state.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Was this page helpful?