BVbvnk
Fiat Payments

List payment limits

Changed on

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. 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
get/governance/v1/limits

Request

Query parameters

qstring
Example:currencies:(EUR OR USD) AND methods:SEPA

Search and filter expression in the Lucene syntax. Use q with AND / OR to combine filters. Format: field1:(value1 OR value2) AND field2:value3.

  • customerIds: Filter by customer UUIDs.
  • limitTypes: Filter by limit type. Values must be TRANSACTION or DAILY.
  • methods: Filter by payment method codes (e.g., SEPA, SWIFT).
  • currencies: Filter by ISO 4217 currency codes (EUR, USD, GBP).
pageinteger

Page number (zero-based).

sizeinteger
Example:20

Number of items per page.

Response

Payment limits retrieved successfully

pageinteger

Current page number (zero-based).

sizeinteger

Number of items per page.

totalElementsinteger

Total number of matching limits.

totalPagesinteger

Total number of pages.

Example response

{
  "content": [
    {
      "id": "6660fa2c-0def-4269-8d0c-6ab5bf2611c0",
      "level": "ACCOUNT",
      "method": "SWIFT",
      "limitType": "TRANSACTION",
      "amount": "10000",
      "currency": "USD",
      "zoneOffset": "+00:00",
      "owner": "ACCOUNT",
      "createdAt": "2026-07-03T12:20:53.276599438Z",
      "updatedAt": "2026-07-03T12:20:53.330993Z"
    }
  ],
  "size": 20,
  "totalElements": 2,
  "totalPages": 1
}

Changes