Rate Limit Exceeded Errors

Guide to troubleshooting rate limit exceeded errors

Rate limit table

Errors of type RATE_LIMIT_EXCEEDED will occur when the rate limit for a particular endpoint has been exceeded. Default rate limit thresholds for some of the most commonly rate-limited endpoints are shown below. Note that these tables are not an exhaustive listing of all Plaid rate limits or rate-limited endpoints, that some users may experience different rate limit thresholds from those shown, and that rate limits are subject to change at any time.

In general, Plaid default rate limits are set such that using the API as designed should typically not cause a rate limit to be encountered. If your use case requires a higher rate limit, contact your Account Manager or file a Support request.

Production and Development rate limits
EndpointMax requests per ItemMax requests per client
/accounts/balance/get5 per minute1,200 per minute
/accounts/get15 per minute15,000 per minute
/asset_report/createN/A30 per minute
/asset_report/get15 per minute1,000 per minute
/asset_report/refreshN/A30 per minute
/auth/get15 per minute12,000 per minute
/identity/get15 per minute2,000 per minute
/identity_verification/*N/A2,000 per minute
/institutions/getN/A25 per minute
/institutions/get_by_idN/A400 per minute
/investments/holdings/get15 per minute2,000 per minute
/investments/transactions/get30 per minute20,000 per minute
/item/get15 per minute5,000 per minute
/item/remove30 per minute2,000 per minute
/liabilities/get15 per minute1,000 per minute
/processor/token/createN/A500 per minute
/transactions/enrichN/A100 per minute
/transactions/get30 per minute20,000 per minute
/transactions/recurring/get20 per minute1,000 per minute
/transactions/refresh2 per minute100 per minute
/transactions/sync30 per minute20,000 per minute
/transfer/authorization/createN/A5,000 per minute
/transfer/cancelN/A30 per minute
/transfer/createN/A5,000 per minute
/transfer/event/syncN/A100 per minute
/transfer/intent/createN/A5,000 per minute
/transfer/migrate_accountN/A30 per minute
/transfer/recurring/cancelN/A30 per minute
/transfer/recurring/createN/A5,000 per minute
/transfer/refund/cancelN/A30 per minute
/transfer/refund/createN/A5,000 per minute
/transfer/*/getN/A100 per minute
/transfer/*/listN/A100 per minute
/watchlist_screening/*N/A2,000 per minute
Sandbox rate limits
EndpointMax requests per ItemMax requests per client
/accounts/balance/get25 per minute100 per minute
/accounts/get100 per minute5,000 per minute
/asset_report/createN/A30 per minute
/asset_report/get1,000 per minute1,000 per minute
/asset_report/refreshN/A100 per minute
/auth/get100 per minute500 per minute
/identity/get100 per minute1,000 per minute
/identity_verification/*N/A500 per minute
/institutions/getN/A10 per minute
/institutions/get_by_idN/A400 per minute
/investments/holdings/get100 per minute1,000 per minute
/investments/transactions/get100 per minute1,000 per minute
/item/get40 per minute5,000 per minute
/item/remove100 per minute500 per minute
/liabilities/get10 per minute1,000 per minute
/processor/token/createN/A500 per minute
/transactions/enrichN/A100 per minute
/transactions/get80 per minute1,000 per minute
/transactions/recurring/get20 per minute1,000 per minute
/transactions/refresh2 per minute100 per minute
/transactions/sync80 per minute1,000 per minute
/transfer/authorization/createN/A100 per minute
/transfer/createN/A100 per minute
/transfer/intent/createN/A100 per minute
/transfer/recurring/createN/A100 per minute
/transfer/refund/createN/A100 per minute
/watchlist_screening/*N/A500 per minute

ACCOUNTS_LIMIT

Too many requests were made to the /accounts/get endpoint.
Common causes
  • Too many requests were made in a short period of time. Requests to /accounts/get in Production and Development environments are rate limited at a maximum of 15 requests per Item per minute and 15,000 per client per minute. In the Sandbox, they are are limited at a maximum of 100 per Item per minute and 5,000 per client per minute.
Troubleshooting steps
1http code 429
2{
3 "error_type": "RATE_LIMIT_EXCEEDED",
4 "error_code": "ACCOUNTS_LIMIT",
5 "error_message": "rate limit exceeded for attempts to access this item. please try again later",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

ACCOUNTS_BALANCE_GET_LIMIT

Too many requests were made to the /accounts/balance/get endpoint.
Common causes
  • Too many requests were made in a short period of time by a single client. Requests to /account/balance/get in Production and Development environments are client rate limited to 1,200 requests per client per minute. In the Sandbox environment, they are client rate limited at a maximum of 100 requests per client per minute.
Troubleshooting steps
1http code 429
2{
3 "error_type": "RATE_LIMIT_EXCEEDED",
4 "error_code": "ACCOUNTS_BALANCE_GET_LIMIT",
5 "error_message": "rate limit exceeded for attempts to access this item. please try again later",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

ADDITION_LIMIT

You have exceeded your addition limit in our Development environment. To increase it, or raise it from zero, contact us.
User-facing error message
Addition Limit Exceeded: The client_id associated with this account has exceeded the maximum number of additions allowed in development mode. Contact Support to resolve
Common causes
  • You attempted to add more Items than currently allowed in the Development environment. The default number of Items allowed in the Development environment can be either 0 or 5, and requesting Development access can increase this number to 100.
  • Note that active Items are counted differently in Development than in Production. Unlike in Production, an Item in Development is counted toward the Item limit as soon as the end user successfully submits valid credentials, even if they do not end up completing the link process, and remains counted even if the access_token is removed.
Troubleshooting steps
1http code 429
2{
3 "error_type": "RATE_LIMIT_EXCEEDED",
4 "error_code": "ADDITION_LIMIT",
5 "error_message": "development addition attempt limit exceeded for this client_id. contact support to increase the limit.",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

AUTH_LIMIT

Too many requests were made to the /auth/get endpoint.
Common causes
  • Too many requests were made in a short period of time. Requests to /auth/get in Production and Development environments are rate limited at a maximum of 15 requests per Item per minute and 12,000 per client per minute. In the Sandbox, they are rate limited at a maximum of 100 requests per Item per minute and 500 requests per client per minute.
Troubleshooting steps
1http code 429
2{
3 "error_type": "RATE_LIMIT_EXCEEDED",
4 "error_code": "AUTH_LIMIT",
5 "error_message": "rate limit exceeded for attempts to access this item. please try again later",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

BALANCE_LIMIT

Too many requests were made to the /accounts/balance/get endpoint.
Common causes
  • Too many requests were made for a single Item in a short period of time. Requests to /account/balance/get in Production and Development environments are Item rate limited at a maximum of 5 requests per Item per minute. In the Sandbox environment, they are Item rate limited at a maximum of 25 requests per Item per minute.
Troubleshooting steps
1http code 429
2{
3 "error_type": "RATE_LIMIT_EXCEEDED",
4 "error_code": "BALANCE_LIMIT",
5 "error_message": "rate limit exceeded for attempts to access this item. please try again later",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

IDENTITY_LIMIT

Too many requests were made to the /identity/get endpoint.
Common causes
  • Too many requests were made in a short period of time. Requests to /identity/get in Production and Development environments are rate limited at a maximum of 15 requests per Item per minute and 2,000 per client per minute. In the Sandbox environment, they are rate limited at a maximum of 100 requests per Item per minute and 1,000 requests per client per minute.
Troubleshooting steps
1http code 429
2{
3 "error_type": "RATE_LIMIT_EXCEEDED",
4 "error_code": "IDENTITY_LIMIT",
5 "error_message": "rate limit exceeded for attempts to access this item. please try again later",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

INSTITUTIONS_GET_LIMIT

Too many requests were made to the /institutions/get endpoint.
Common causes
  • Too many requests were made in a short period of time. Requests to /institutions/get in Production and Development environments are rate limited at a maximum of 25 per client per minute. In the Sandbox environment, they are rate limited at a maximum of 10 requests per client per minute.
Troubleshooting steps
1http code 429
2{
3 "error_type": "RATE_LIMIT_EXCEEDED",
4 "error_code": "INSTITUTIONS_GET_LIMIT",
5 "error_message": "rate limit exceeded for attempts to access \"institutions get by id\". please try again later",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

INSTITUTIONS_GET_BY_ID_LIMIT

Too many requests were made to the /institutions/get_by_id endpoint.
Common causes
  • Too many requests were made in a short period of time. Requests to /institutions/get_by_id are rate limited at a maximum of 400 requests per client per minute.
Troubleshooting steps
1http code 429
2{
3 "error_type": "RATE_LIMIT_EXCEEDED",
4 "error_code": "INSTITUTIONS_GET_BY_ID_LIMIT",
5 "error_message": "rate limit exceeded for attempts to access \"institutions get by id\". please try again later",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

INVESTMENT_HOLDINGS_GET_LIMIT

Too many requests were made to the /investments/holdings/get endpoint.
Common causes
  • Too many requests were made in a short period of time. Requests to /investments/holdings/get in Production and Development environments are rate limited at a maximum of 15 requests per Item per minute and 2,000 per client per minute. In the Sandbox environment, they are rate limited at a maximum of 100 requests per Item per minute and 1,000 requests per client per minute.
Troubleshooting steps
1http code 429
2{
3 "error_type": "RATE_LIMIT_EXCEEDED",
4 "error_code": "INVESTMENT_HOLDINGS_GET_LIMIT",
5 "error_message": "rate limit exceeded for attempts to access this item. please try again later",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

INVESTMENT_TRANSACTIONS_LIMIT

Too many requests were made to the /investments/transactions/get endpoint.
Common causes
  • Too many requests were made in a short period of time. Requests to /investments/transactions/get in Production and Development environments are rate limited at a maximum of 30 requests per Item per minute and 20,000 per client per minute. In the Sandbox environment, they are rate limited at a maximum of 100 requests per Item per minute and 1,000 requests per client per minute.
Troubleshooting steps
1http code 429
2{
3 "error_type": "RATE_LIMIT_EXCEEDED",
4 "error_code": "INVESTMENT_TRANSACTIONS_LIMIT",
5 "error_message": "rate limit exceeded for attempts to access this item. please try again later",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

ITEM_GET_LIMIT

Too many requests were made to the /item/get endpoint.
Common causes
  • Too many requests were made in a short period of time. Requests to /item/get in Production and Development environments are rate limited at a maximum of 15 requests per Item per minute and 5,000 per client per minute. In the Sandbox environment, they are rate limited at a maximum of 40 requests per Item per minute and 5,000 requests per client per minute.
Troubleshooting steps
1http code 429
2{
3 "error_type": "RATE_LIMIT_EXCEEDED",
4 "error_code": "ITEM_GET_LIMIT",
5 "error_message": "rate limit exceeded for attempts to access this item. please try again later",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

RATE_LIMIT

Too many requests were made.
Common causes
  • Too many requests were made in a short period of time.
  • Sandbox credentials (the username user_good or user_custom) were used to attempt to log in to Production or Development. Because using these credentials in a live environment is a common misconfiguration, they are frequently subject to rate limiting in those environments.
  • A Link attempt was detected as potential attempted abuse. For example, this may occur if a user enters their credentials incorrectly too many times in a row.
Troubleshooting steps
1http code 429
2{
3 "error_type": "RATE_LIMIT_EXCEEDED",
4 "error_code": "RATE_LIMIT",
5 "error_message": "rate limit exceeded for attempts to access this item. please try again later",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

TRANSACTIONS_LIMIT

Too many requests were made to the /transactions/get endpoint.
Common causes
  • Too many requests were made in a short period of time. Requests to /transactions/get and /transactions/sync in Production and Development environments are rate limited at a maximum of 30 requests per Item per minute and 20,000 per client per minute. In the Sandbox environment, they are rate limited at a maximum of 80 requests per Item per minute and 1,000 requests per client per minute.
Troubleshooting steps
1http code 429
2{
3 "error_type": "RATE_LIMIT_EXCEEDED",
4 "error_code": "TRANSACTIONS_LIMIT",
5 "error_message": "rate limit exceeded for attempts to access this item. please try again later",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}