---
title: "List customer's fiat wallets"
method: GET
path: "/ledger/v1/wallets"
tags: ["Fiat Payments"]
deprecated: true
---

# List customer's fiat wallets

`GET /ledger/v1/wallets`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/ledger/v1/wallets`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/ledger/v1/wallets/get.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

Retrieves a list of wallets for your customers.

• **Without parameters**: Returns all wallets associated with all your customers.

• **With `customerReference` parameter**: Returns wallets for a specific customer only. Usage: `https://api.bvnk.com/ledger/v1/wallets?customerReference=550e8400-e29b-41d4-a716-446655440000
`.

**Deprecated:** use `GET /ledger/v2/wallets` instead.

## Query parameters

- `currencyCode` 'USD' | 'EUR' | 'GBP' | 'USDT' | 'POL' | 'PYUSD' | 'BTC' | 'SOL' | 'BNB' | 'XRP' | 'ETH' | 'LTC' | 'USDC' | 'USDG' | 'TRX'
- `customerReference` string, uuid
- `page` integer
- `size` integer
- `sort` string
- `offset` integer

## Response `200`

OK

- object
  - `content` WalletResponse[]
    - `id` string, required: Unique wallet ID.
    - `accountReference` string, uuid, required: Account reference for this wallet.
    - `customerReference` string, uuid, required: Customer reference for this wallet.
    - `name` string, required: Name of the wallet.
    - `status` 'ACTIVE' | 'INACTIVE' | 'TERMINATED', required: Status of the wallet.
    - `balance` Balance, required: Information about the available balance of the wallet.
      - `value` number, float, required: Available amount of funds in the wallet.
      - `currencyCode` 'USD' | 'EUR' | 'GBP' | 'USDT' | 'POL' | 'PYUSD' | 'BTC' | 'SOL' | 'BNB' | 'XRP' | 'ETH' | 'LTC' | 'USDC' | 'USDG' | 'TRX', required: Wallet currency.
    - `ledgers` Ledger[], required
      - union
        - FiatLedger: Information about the fiat ledger. If the wallet is enabled for SWIFT, the `paymentReference` is returned
          - `type` 'FIAT', required: Type of ledger, must be FIAT for this schema.
          - `accountHolderName` string: Name of the account holder.
          - `accountNumber` string, required: Account number. Must be provided only if `type` = `FIAT`.
          - `code` string, required: Bank identification code (BIC/SWIFT code).
          - `accountNumberFormat` string: Format of the account number.
          - `paymentReference` string: Reference to include with the payment.
          - `bank` object: Bank details associated with the fiat ledger.
            - `identificationCode` string: Bank identification code (BIC/SWIFT code).
            - `name` string: Name of the bank.
            - `address` Address
              - …
        - CryptoLedger
          - `type` 'CRYPTO', required: Type of ledger, must be CRYPTO for this schema.
          - `address` string, required: Crypto wallet address. Must be provided only if `type` = `CRYPTO`.
          - `network` string, required: Crypto wallet network or protocol. Must be provided only if `type` = `CRYPTO`.
          - `tag` string: Optional crypto tag or memo, if required by the network.
    - `capabilities` 'SAFEGUARDED': Flag that shows that funds or assets are protected and kept separate from a company's own money. They can't be used for business operations or debts and remain available to the rightful owners.
  - `pageable` object
    - `pageNumber` integer: The current page number.
    - `pageSize` integer: Number of items per page.
    - `offset` integer: Offset from the start, calculated as `pageNumber * pageSize`.
  - `totalPages` integer: The total number of available pages
  - `totalElements` integer: The total number of elements across all pages
  - `numberOfElements` integer: The number of elements in the current page
  - `last` boolean: Whether this is the last page
  - `first` boolean: Whether this is the first page
  - `empty` boolean: Whether the page contains no elements

## Changes

- **2026-06-16** `97d6c0d2fe2e`: 1 info
  - endpoint deprecated

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/ledger/v1/wallets/get.md)

---

[API](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints.md) - [All operations](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/revisions/c386d436bf2c?raw)