---
title: "List transactions"
method: GET
path: "/api/v1/bila/transactions"
tags: ["Transactions"]
---

# List transactions

`GET /api/v1/bila/transactions`

Retrieve a paginated list of transactions

## Query parameters

- `page` number
- `perPage` number
- `type` 'credit' | 'debit' — Transaction type
- `accountId` string
- `startDate` string
- `endDate` string

## Response `200`

Transactions retrieved successfully

- object
  - `status` boolean, required — Request success status
  - `message` string, required — Response message
  - `data` PaginatedTransactionsResponseDto
    - `data` TransactionResponseDto[], required — List of transactions
      - `id` string, required — Transaction UUID
      - `type` 'credit' | 'debit', required — Transaction type
      - `amount` number, required — Transaction amount
      - `currency` string, required — Currency code
      - `status` 'pending' | 'successful' | 'failed' | 'cancelled', required — Transaction status
      - `description` string — Transaction description
      - `reference` string — Client reference
      - `accountId` string, required — Account / wallet ID
      - `balanceBefore` number, required — Balance before transaction
      - `balanceAfter` number, required — Balance after transaction
      - `createdAt` string, date-time, required — Transaction timestamp
    - `meta` PaginationMetaDto, required
      - `total` number, required — Total number of records
      - `perPage` number, required — Items per page
      - `currentPage` number, required — Current page number
      - `pageCount` number, required — Total number of pages

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/bilasdk/apis/bila-payment-gateway-api.md) · [All operations](https://skmtc.net/bilasdk/apis/bila-payment-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bilasdk/bila-payment-gateway-api/revisions/1e6976632889/schema)