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

# Get wallet profiles

`GET /ledger/v2/wallets/profiles`

## Request

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

Returns available wallet profiles based on optional filters for currency codes and payment methods. For more information on how to apply it in the Embedded Wallets flow, refer to the [Retrieve wallet profiles](/bvnk/get-started/set-up-wallets/#retrieve-wallet-profiles) guide.

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/profiles?q=customerId:550e8400-e29b-41d4-a716-446655440000 AND currency:USD` returns USD wallet profiles 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`

List of wallet profiles matching the query

- object
  - `totalElements` integer, required: Total number of wallet profiles matching the query.
  - `totalPages` integer, required: Total number of pages available.
  - `content` object[], required: List of wallet profiles.
    - `id` string, required: Profile ID to be assigned to the Customer's wallet based on the currency and payment method.
    - `currencies` string[], required: Wallet's currency.
    - `methods` string[], required: Payment methods available for the wallet.
  - `pageable` object, required: Pagination details for the current request.
    - `pageNumber` integer, required: Current page number (zero-based).
    - `pageSize` integer, required: Number of items per page.
  - `hasNext` boolean, required: Whether there is a next page of results.

## Other responses

- `400`: Bad request.
- `401`: Authentication required.
- `403`: Forbidden.
- `429`: Rate limited — too many requests.

## Changes

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

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