GET
/
api
/
v1
/
transactions
/
applications
/
{application_id}
/
prepaid-details
Get Prepaid Details
curl --request GET \
  --url https://hpay-api.host-sl.com/api/v1/transactions/applications/{application_id}/prepaid-details \
  --header 'api-key: <api-key>'
{
  "balance": 245.50,
  "currency": "USD",
  "overdraft_limit": -50.00,
  "audit_logs": [
    {
      "id": "e2c34a2c-c82b-4569-b5f6-7bdf9f67a213",
      "amount_change": 50.00,
      "previous_balance": 195.50,
      "new_balance": 245.50,
      "reason": "prepaid_funding",
      "description": "Prepaid Mobile Money top-up via Monime (Payment ID: pmt_monime_9988)",
      "timestamp": "2026-06-09T13:20:00Z"
    },
    {
      "id": "f5123d44-aa2b-449e-ba21-12c3f81e3f22",
      "amount_change": -1.50,
      "previous_balance": 197.00,
      "new_balance": 195.50,
      "reason": "platform_fee",
      "description": "Platform fee of 1.00% charged on Gross Amount 150.00 USD (Txn: txn_87362)",
      "timestamp": "2026-06-09T12:05:00Z"
    }
  ]
}
This endpoint retrieves the active prepaid balance of the application’s platform_prepaid wallet, the application’s base currency, the current overdraft limit threshold, and a list of the 50 most recent wallet audit logs.

​
Query Parameters

​
live_mode
boolean
default:"true"
Specifies whether to fetch information from the live or test schema environment.

​
Path Parameters

​
application_id
string
required
The unique identifier of the client-managed application.

​
Response

​
balance
number
The active balance in the prepaid wallet.
​
currency
string
The application’s configured base currency (e.g. USD or SLE).
​
overdraft_limit
number
The overdraft threshold at which write transactions will be blocked (e.g. -50.00).
​
audit_logs
array
A list of recent audit logs for the prepaid wallet.
{
  "balance": 245.50,
  "currency": "USD",
  "overdraft_limit": -50.00,
  "audit_logs": [
    {
      "id": "e2c34a2c-c82b-4569-b5f6-7bdf9f67a213",
      "amount_change": 50.00,
      "previous_balance": 195.50,
      "new_balance": 245.50,
      "reason": "prepaid_funding",
      "description": "Prepaid Mobile Money top-up via Monime (Payment ID: pmt_monime_9988)",
      "timestamp": "2026-06-09T13:20:00Z"
    },
    {
      "id": "f5123d44-aa2b-449e-ba21-12c3f81e3f22",
      "amount_change": -1.50,
      "previous_balance": 197.00,
      "new_balance": 195.50,
      "reason": "platform_fee",
      "description": "Platform fee of 1.00% charged on Gross Amount 150.00 USD (Txn: txn_87362)",
      "timestamp": "2026-06-09T12:05:00Z"
    }
  ]
}

curl --request GET \
  --url https://hpay-api.host-sl.com/api/v1/transactions/applications/YOUR_APP_ID/prepaid-details?live_mode=true \
  --header 'api-key: YOUR_API_KEY' \
  --header 'secret-key: YOUR_SECRET_KEY'