Skip to main content
The Transactions API provides a unified view of all transactions across your accounts.

​
Overview

Use transactions to:
  • View all credits and debits
  • Track payment history
  • Generate reports
  • Reconcile your accounts

​
Endpoints

EndpointMethodDescription
/bila/transactionsGETList all transactions
/bila/transactions/{id}GETGet a single transaction by ID

​
Transaction Object

{
  "id": "txn-001",
  "type": "credit",
  "amount": 1000.00,
  "currency": "ZMW",
  "status": "successful",
  "description": "Mobile money collection",
  "reference": "order-12345",
  "accountId": "acc-001",
  "balanceBefore": 5000.00,
  "balanceAfter": 6000.00,
  "createdAt": "2024-01-15T10:30:00Z"
}

​
Transaction Types

TypeDescription
creditMoney received (collections, deposits)
debitMoney sent (transfers, fees)

​
Filtering Transactions

You can filter transactions using query parameters:
ParameterTypeDescription
pagenumberPage number (default: 1)
perPagenumberItems per page (default: 50, max: 100)
typestringFilter by type: credit or debit
accountIdstringFilter by account ID
startDatestringFilter from date (ISO 8601)
endDatestringFilter to date (ISO 8601)

​
Example: Get Recent Credits

curl -X GET "https://api.usebila.com/api/v1/bila/transactions?type=credit&perPage=20" \
  -H "x-api-key: sk_test_your_api_key"

​
Example: Get Transactions for Date Range

curl -X GET "https://api.usebila.com/api/v1/bila/transactions?startDate=2024-01-01&endDate=2024-01-31" \
  -H "x-api-key: sk_test_your_api_key"

​
Paginated Response

{
  "status": true,
  "message": "Transactions retrieved successfully",
  "data": {
    "data": [
      // Transaction objects
    ],
    "meta": {
      "total": 150,
      "page": 1,
      "perPage": 50,
      "totalPages": 3
    }
  }
}

​
Use Cases

Fetch transactions for the previous day to reconcile with your internal records.
Use date filters to generate monthly or weekly transaction statements.
List recent transactions to monitor account activity in real-time.

API Reference

View the interactive API reference for Transactions endpoints