Skip to main content
GET
/
logEntries
curl --location 'https://api.bleeprs.com/api/logEntries?status=success&network=mtn&search=08107176819&startdate=2025-09-17&enddate=2025-09-17&page=0&perPage=1&download=true' \
--header 'Authorization: Bearer YOUR_API_KEY'

{
  "gatewayStatus": "<string>",
  "gatewayMessage": "<string>",
  "requestReference": "<string>",
  "data": {},
  "TotalPages": 123,
  "CurrentPage": 123,
  "TotalRecords": 123,
  "NextPage": "<string>",
  "PreviousPage": "<string>",
  "Items": [
    {}
  ],
  "id": 123,
  "transaction_id": "<string>",
  "partner_reference": "<string>",
  "phone_number": "<string>",
  "amount": "<string>",
  "transaction_cost": 123,
  "commission": 123,
  "balance_after": 123,
  "type": "<string>",
  "network": "<string>",
  "operator": "<string>",
  "region": "<string>",
  "description": "<string>",
  "data_plan": "<string>",
  "status": "<string>",
  "time": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>"
}

​
Overview

Retrieve detailed transaction logs for your vending activities. Filter by status, network, date range, and search by phone number or transaction ID.

​
Request

curl --location 'https://api.bleeprs.com/api/logEntries?status=success&network=mtn&search=08107176819&startdate=2025-09-17&enddate=2025-09-17&page=0&perPage=1&download=true' \
--header 'Authorization: Bearer YOUR_API_KEY'

​
Parameters

​
Response

​
gatewayStatus
string
Status code indicating success (“00”) or error
​
gatewayMessage
string
Human-readable status message
​
requestReference
string
Unique reference ID for tracking this request
​
data
object
Paginated transaction logs

​
Data Object Fields

​
TotalPages
number
Total number of pages available
​
CurrentPage
number
Current page number
​
TotalRecords
number
Total number of records matching the filter
​
NextPage
string
URL for next page (empty if no next page)
​
PreviousPage
string
URL for previous page (empty if no previous page)
​
Items
array
Array of transaction log entries

​
Transaction Log Entry Fields

​
id
number
Unique transaction ID
​
transaction_id
string
External transaction reference
​
partner_reference
string
Partner reference number
​
phone_number
string
Recipient phone number
​
amount
string
Transaction amount (e.g., “N200.00”)
​
transaction_cost
number
Actual cost charged
​
commission
number
Commission earned
​
balance_after
number
Account balance after transaction
​
type
string
Transaction type (AIRTIME, DATA)
​
network
string
Network provider (MTN, GLOBACOM, etc.)
​
operator
string
Operator name
​
region
string
Geographic region
​
description
string
Transaction description
​
data_plan
string
Data plan product code (for data transactions)
​
status
string
Transaction status (SUCCESS, FAILED)
​
time
string
Human-readable transaction time
​
created_at
string
Transaction creation timestamp
​
updated_at
string
Last update timestamp

​
Example Response

{
  "gatewayStatus": "00",
  "gatewayMessage": "Sucessfully Processed",
  "requestReference": "iip9r710KslnmtdAgb1w",
  "data": {
    "TotalPages": 1,
    "CurrentPage": 1,
    "TotalRecords": 7,
    "NextPage": "",
    "PreviousPage": "",
    "Items": [
      {
        "amount": "N200.00",
        "balance_after": 4455.5,
        "commission": 2,
        "created_at": "2025-09-18T08:21:34.530768Z",
        "data_plan": "LV_MTN_XTRADATA_3DAYS_200_200",
        "description": "LV_MTN",
        "id": 25,
        "network": "MTN",
        "operator": "",
        "partner_reference": "REFQ000339",
        "phone_number": "08107176819",
        "region": "MTN",
        "status": "SUCCESS",
        "time": "9/18/2025",
        "transaction_cost": 198,
        "transaction_id": "REFQ000339",
        "type": "DATA",
        "updated_at": "2025-09-18T08:21:34.530768Z"
      },
      {
        "amount": "N50.00",
        "balance_after": 4653.5,
        "commission": 0.5,
        "created_at": "2025-09-18T08:20:59.867764Z",
        "data_plan": "MTN",
        "description": "LA_MTN",
        "id": 24,
        "network": "MTN",
        "operator": "",
        "partner_reference": "REFQ000178667",
        "phone_number": "08107176819",
        "region": "MTN",
        "status": "SUCCESS",
        "time": "9/18/2025",
        "transaction_cost": 49.5,
        "transaction_id": "REFQ000178667",
        "type": "AIRTIME",
        "updated_at": "2025-09-18T08:20:59.867764Z"
      }
    ]
  }
}

​
Notes

  • Use pagination parameters to navigate through large result sets
  • Date filters are inclusive of both start and end dates
  • Search functionality works with partial phone numbers or transaction IDs
  • All timestamps are in UTC format
  • Commission amounts are in Naira
  • Use this endpoint to track transaction history and troubleshoot issues