---
title: "Filter and view the transfer limits"
method: GET
path: "/balanceAccounts/{id}/transferLimits"
tags: ["Transfer limits - balance account level"]
---

# Filter and view the transfer limits

`GET /balanceAccounts/{id}/transferLimits`

Filter and view the transfer limits configured for a balance account using the balance account's unique `id` and the available query parameters.

## Path parameters

- `id` string, required

## Query parameters

- `scope` 'perDay' | 'perTransaction' — The scope to which the transfer limit applies. Possible values: * **perTransaction**: you set a maximum amount for each transfer made from the balance account or balance platform. * **perDay**: you set a maximum total amount for all transfers made from the balance account or balance platform in a day.
- `transferType` 'instant' | 'all' — The type of transfer to which the limit applies. Possible values: * **instant**: the limit applies to transfers with an **instant** priority. * **all**: the limit applies to all transfers, regardless of priority.
- `status` 'active' | 'inactive' | 'pendingSCA' | 'scheduled' — The status of the transfer limit. Possible values: * **active**: the limit is currently active. * **inactive**: the limit is currently inactive. * **pendingSCA**: the limit is pending until your user performs SCA. * **scheduled**: the limit is scheduled to become active at a future date.

## Response `200`

OK - The request has succeeded.

- TransferLimitListResponse
  - `transferLimits` TransferLimit[], required — List of available transfer limits.
    - `amount` Amount, required
      - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
      - `value` integer, required — The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
    - `endsAt` string, date-time — The date and time when the transfer limit becomes inactive. If you do not specify an end date, the limit stays active until you override it with a new limit. Format [ISO 8601](https://www.w3.org/TR/NOTE-datetime): **YYYY-MM-DDThh:mm:ss.sssTZD**
    - `id` string, required — The unique identifier of the transfer limit.
    - `limitStatus` 'active' | 'inactive' | 'pendingSCA' | 'scheduled', required — The status of the transfer limit. Possible values: * **active**: the limit is currently active. * **inactive**: the limit is currently inactive. * **pendingSCA**: the limit is pending until your user performs SCA. * **scheduled**: the limit is scheduled to become active at a future date.
    - `reference` string — Your reference for the transfer limit.
    - `scaInformation` ScaInformation
      - `exemption` 'setByPlatform' | 'initialLimit' | 'lowerLimit' | 'notRegulated' | 'alreadyPerformed' — The type of exemption for Strong Customer Authentication (SCA). Possible values: * **lowerLimit**: the newly created limit is lower than the existing limit. * **notRegulated**: the limit is created in a country, region, or industry where it is not mandated by law to use SCA. * **setByPlatform**: you set a limit for one of your user's balance accounts, or for your balance platform. * **initialLimit**: there are no existing transfer limits set on the balance account or balance platform. * **alreadyPerformed**: you are confident about your user's identity and do not need to verify this using SCA.
      - `status` 'notPerformed' | 'pending' | 'performed', required — The status of Strong Customer Authentication (SCA). Possible values: * **notPerformed**: the requester was unable to successfully authenticate the request using SCA, or has an SCA exemption. * **pending**: the request is pending SCA authentication. * **performed**: the request is successfully authenticated using SCA.
    - `scope` 'perDay' | 'perTransaction', required — The scope to which the transfer limit applies. Possible values: * **perTransaction**: you set a maximum amount for each transfer made from the balance account or balance platform. * **perDay**: you set a maximum total amount for all transfers made from the balance account or balance platform in a day.
    - `startsAt` string, date-time, required — The date and time when the transfer limit becomes active. If you specify a date in the future, we will schedule a transfer limit. Format [ISO 8601](https://www.w3.org/TR/NOTE-datetime): **YYYY-MM-DDThh:mm:ss.sssTZD**
    - `transferType` 'instant' | 'all', required — The type of transfer to which the limit applies. Possible values: * **instant**: the limit applies to transfers with an **instant** priority. * **all**: the limit applies to all transfers, regardless of priority.

## Other responses

- `404` — Not found - One of the transfer limits could not be found.
- `422` — Unprocessable Content - A request validation error.

---

[API](https://skmtc.net/adyen/apis/balanceplatformservice.md) · [All operations](https://skmtc.net/adyen/apis/balanceplatformservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/balanceplatformservice/revisions/8761ac1a9aab/schema)