---
title: "List all accounts"
method: GET
path: "/api/v1/bila/accounts"
tags: ["Accounts"]
---

# List all accounts

`GET /api/v1/bila/accounts`

Retrieve a paginated list of accounts/wallets for the authenticated merchant

## Query parameters

- `page` number
- `perPage` number

## Response `200`

Accounts retrieved successfully

- object
  - `status` boolean, required — Request success status
  - `message` string, required — Response message
  - `data` PaginatedAccountsResponseDto
    - `data` AccountResponseDto[], required — List of accounts
      - `id` string, uuid, required — Account UUID
      - `type` 'main' | 'sub' | 'virtual', required — Account type
      - `status` 'active' | 'inactive' | 'suspended', required — Account status
      - `currency` string, required — Currency code
      - `createdAt` string, date-time, required — Account creation timestamp
      - `details` AccountDetailsDto, required
        - `type` string, required — Account detail type
        - `accountName` string, required — Account holder name
        - `tillNumber` string — Till number (for mobile money)
      - `availableBalance` string — Available balance
      - `ledgerBalance` string — Ledger balance
    - `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

- `401` — Unauthorized - Invalid or missing API key

---

[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)