---
title: "List transfer recipients"
method: GET
path: "/api/v1/bila/transfer-recipients"
tags: ["Transfer Recipients"]
---

# List transfer recipients

`GET /api/v1/bila/transfer-recipients`

Retrieve a paginated list of saved transfer recipients

## Query parameters

- `page` number
- `perPage` number
- `type` 'bank-account' | 'mobile-money' — Transfer recipient type

## Response `200`

Recipients retrieved successfully

- object
  - `status` boolean, required — Request success status
  - `message` string, required — Response message
  - `data` PaginatedRecipientsResponseDto
    - `data` RecipientResponseDto[], required — List of recipients
      - `id` string, uuid, required — Recipient UUID
      - `type` 'bank-account' | 'mobile-money', required — Transfer recipient type
      - `accountNumber` string — Bank account number (bank-account only)
      - `accountName` string, required — Account holder name
      - `bankId` string — Bank ID (bank-account only)
      - `bankName` string — Bank name (bank-account only)
      - `phone` string — Phone number (mobile-money only)
      - `operator` string — Mobile money operator (mobile-money only)
      - `country` string, required — Country code
      - `createdAt` string, date-time, required — Creation 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)