---
title: "Get wallets"
method: GET
path: "/ledger/v2/wallets"
tags: ["Fiat Payments"]
---

# Get wallets

`GET /ledger/v2/wallets`

## Request

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

Shows all *Direct* and *Customer* wallet types. Results are summaries only (**payment instruments are not included**); use `GET /ledger/v2/wallets/{id}` to retrieve a single wallet with full details including payment instruments.

The endpoint uses the [Lucene query syntax](https://lucene.apache.org/core/2_9_4/queryparsersyntax.html), for example, `GET https://api.bvnk.com/ledger/v2/wallets?q=customerId:550e8400-e29b-41d4-a716-446655440000 AND status:(ACTIVE OR INACTIVE)` returns all active and inactive wallets for that customer.

**Note:** Field names in the `q` search expression are case-sensitive. If you use a field that is not recognised, it is ignored.

Operator `OR` is only supported within the same field (group alternatives with parentheses), not across different fields.

- Supported: `?q=currency:(USD OR EUR)`
- Not supported: `?q=currency:USD OR customerId:550e8400-e29b-41d4-a716-446655440000`

## Query parameters

- `q` string
- `pageNumber` integer
- `pageSize` integer

## Response `200`

OK

- LedgerWalletV2ListResponse
  - `content` LedgerWalletV2ListItem[]
    - `id` string: The wallet identifier.
    - `name` string: Display name of the wallet.
    - `customer` LedgerWalletV2Customer: Customer with which this wallet is associated. Shown only for customer wallets.
      - `id` string, uuid: Unique identifier for the customer.
      - `name` string: Display name for the customer.
    - `status` 'ACTIVE' | 'INACTIVE' | 'TERMINATED': Status of the wallet.
    - `balance` LedgerWalletV2Balance: Information about the available balance of the wallet.
      - `amount` number, required: Balance amount as a decimal string for fixed precision.
      - `currency` string, required
    - `createdAt` string, date-time: Timestamp when the wallet was created in ISO 8601 format.
    - `updatedAt` string, date-time: Timestamp of the most recent update to the wallet in ISO 8601 format.
  - `pageable` LedgerWalletV2Pageable
    - `pageNumber` integer: Current page index (0-based).
    - `pageSize` integer: Page size.
  - `hasNext` boolean: Flag that shows whether another page of results exists.

## Other responses

- `400`: Bad request.
- `403`: Forbidden.

## Changes

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

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/ledger/v2/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)