---
title: "List transfers"
method: GET
path: "/api/v1/bila/transfers"
tags: ["Transfers"]
---

# List transfers

`GET /api/v1/bila/transfers`

Retrieve a paginated list of transfers/payouts for the authenticated merchant

## Query parameters

- `page` number
- `perPage` number
- `status` 'pending' | 'successful' | 'failed'
- `type` 'bank-account' | 'mobile-money' — Transfer recipient type
- `accountId` string
- `startDate` string
- `endDate` string

## Response `200`

Transfers retrieved successfully

- object
  - `status` boolean, required — Request success status
  - `message` string, required — Response message
  - `data` PaginatedTransfersResponseDto
    - `data` TransferResponseDto[], required — List of transfers
      - `id` string, required — Transfer ID
      - `reference` string, required — Client reference
      - `type` 'bank-account' | 'mobile-money', required — Transfer recipient type
      - `status` 'pending' | 'successful' | 'failed', required — Transfer status
      - `amount` number, required — Transfer amount
      - `currency` string, required — Currency code
      - `narration` string — Transfer narration
      - `recipient` TransferRecipientDto, required
        - `accountNumber` string — Bank account number (bank-account only)
        - `accountName` string, required — Account holder / recipient name
        - `bankName` string — Bank name (bank-account only)
        - `phone` string — Phone number (mobile-money only)
        - `operator` string — Mobile money operator (mobile-money only)
      - `createdAt` string, date-time, required — Creation timestamp (from Payment)
      - `completedAt` string, date-time — Completion timestamp (from Payment.processedAt)
    - `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)