v3

latestOpenAPI 3.0.0raw.githubusercontent.com2026-06-10283986.5 KB
Transactions

List transactions

Retrieve a paginated list of transactions

get/api/v1/bila/transactions

Query parameters

pagenumber
Example:1

Page number (default: 1)

perPagenumber
Example:50

Items per page (default: 50)

type'credit' | 'debit'

Transaction type

Example:credit

Filter by transaction type

accountIdstring
Example:68f11209-451f-4a15-bfcd-d916eb8b09f4

Filter by account ID

startDatestring
Example:2024-01-01T00:00:00Z

Filter by start date (ISO 8601)

endDatestring
Example:2024-12-31T23:59:59Z

Filter by end date (ISO 8601)

Response

Transactions retrieved successfully

statusboolean required

Request success status

messagestring required

Response message

Example response

{
  "status": true,
  "message": "Operation completed successfully",
  "data": {
    "data": [
      {
        "id": "txn-001",
        "type": "credit",
        "amount": 1000,
        "currency": "ZMW",
        "status": "successful",
        "description": "Mobile money collection",
        "reference": "order-12345",
        "accountId": "acc-001",
        "balanceBefore": 5000,
        "balanceAfter": 6000,
        "createdAt": "2024-01-15T10:30:00Z"
      }
    ],
    "meta": {
      "total": 150,
      "perPage": 50,
      "currentPage": 1,
      "pageCount": 3
    }
  }
}