---
title: "List payment limits"
method: GET
path: "/governance/v1/limits"
tags: ["Fiat Payments"]
---

# List payment limits

`GET /governance/v1/limits`

## Request

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

Retrieves all payment limits configured for the authenticated account. Supports filtering by customer, limit type, payment method, and currency.

The endpoint uses the [Lucene query syntax](https://lucene.apache.org/core/2_9_4/queryparsersyntax.html). Use the `q` query parameter to filter results.

For example, `GET https://api.bvnk.com/governance/v1/limits?q=currencies:(EUR OR USD) AND methods:SEPA` returns all SEPA limits in EUR and USD.

**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=currencies:(EUR OR USD)`
- Not supported: `?q=currencies:EUR OR methods:SEPA`

## Query parameters

- `q` string
- `page` integer
- `size` integer

## Response `200`

Payment limits retrieved successfully

- PaymentLimitListResponse
  - `content` PaymentLimitDetail[]: List of payment limits.
    - `id` string, uuid: The unique identifier of the payment limit.
    - `level` 'ACCOUNT' | 'ALL_CUSTOMERS' | 'CUSTOMER': The level at which the limit is applied.
    - `customerId` string, uuid: The customer identifier, if the limit applies to a specific customer.
    - `method` string: The payment method the limit applies to.
    - `limitType` 'TRANSACTION' | 'DAILY': The type of limit.
    - `amount` string: The limit amount in major currency units.
    - `currency` string: Three-letter ISO-4217 currency code.
    - `zoneOffset` string: The UTC timezone offset for daily limit calculation.
    - `owner` 'ACCOUNT' | 'BVNK': Indicates who created the limit: `ACCOUNT` (created by the partner) or `BVNK` (created by BVNK operations).
    - `createdAt` string, date-time: The timestamp when the payment limit was created.
    - `updatedAt` string, date-time: The timestamp when the payment limit was last updated.
  - `page` integer: Current page number (zero-based).
  - `size` integer: Number of items per page.
  - `totalElements` integer: Total number of matching limits.
  - `totalPages` integer: Total number of pages.

## Changes

- **2026-11-06** `c386d436bf2c`: 1 info
  - endpoint added

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