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, and some users may experience different rate limit thresholds from those shown.

Production and Development rate limits
EndpointMax requests per ItemMax requests per client
/accounts/get15 per minute15,000 per minute
/asset_report/get15 per minute1,000 per minute
/auth/get15 per minute12,000 per minute
/accounts/balance/get5 per minute1,200 per minute
/identity/get15 per minute2,000 per minute
/institutions/getN/A25 per minute
/institutions/get_by_idN/A400 per minute
/item/get15 per minute5,000 per minute
/liabilities/get15 per minute1,000 per minute
/transactions/get30 per minute20,000 per minute
/transactions/refresh2 per minute100 per minute
/bank_transfer/create5 per day5,000 per minute
Sandbox rate limits
EndpointMax requests per ItemMax requests per client
/accounts/get100 per minute5,000 per minute
/asset_report/get1,000 per minute1,000 per minute
/auth/get100 per minute500 per minute
/accounts/balance/get25 per minute100 per minute
/identity/get100 per minute1,000 per minute
/institutions/getN/A25 per minute
/institutions/get_by_idN/A400 per minute
/item/get40 per minute5,000 per minute
/liabilities/get10 per minute1,000 per minute
/transactions/get80 per minute1,000 per minute
/transactions/refresh2 per minute100 per minute
/bank_transfer/create10,000 per day100 per minute

ACCOUNTS_LIMIT

Too many requests were made to the /accounts/get endpoint.
Server-Side
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
1
2
3
4
5
6
7
8
http code 429
{
"error_type": "RATE_LIMIT_EXCEEDED",
"error_code": "ACCOUNTS_LIMIT",
"error_message": "rate limit exceeded for attempts to access this item. please try again later",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

ADDITION_LIMIT

You have exceeded your addition limit in our Development environment. To increase it, or raise it from zero, contact us.
Server-Side
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 you obtain a public_token for it, and remains counted even if the access_token is removed.
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 429
{
"error_type": "RATE_LIMIT_EXCEEDED",
"error_code": "ADDITION_LIMIT",
"error_message": "development addition attempt limit exceeded for this client_id. contact support to increase the limit.",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

AUTH_LIMIT

Too many requests were made to the /auth/get endpoint.
Server-Side
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
1
2
3
4
5
6
7
8
http code 429
{
"error_type": "RATE_LIMIT_EXCEEDED",
"error_code": "AUTH_LIMIT",
"error_message": "rate limit exceeded for attempts to access this item. please try again later",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

BALANCE_LIMIT

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

IDENTITY_LIMIT

Too many requests were made to the /identity/get endpoint.
Server-Side
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
1
2
3
4
5
6
7
8
http code 429
{
"error_type": "RATE_LIMIT_EXCEEDED",
"error_code": "IDENTITY_LIMIT",
"error_message": "rate limit exceeded for attempts to access this item. please try again later",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

ITEM_GET_LIMIT

Too many requests were made to the /item/get endpoint.
Server-Side
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
1
2
3
4
5
6
7
8
http code 429
{
"error_type": "RATE_LIMIT_EXCEEDED",
"error_code": "ITEM_GET_LIMIT",
"error_message": "rate limit exceeded for attempts to access this item. please try again later",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

RATE_LIMIT

Too many requests were made.
Server-Side
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.
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 429
{
"error_type": "RATE_LIMIT_EXCEEDED",
"error_code": "RATE_LIMIT",
"error_message": "rate limit exceeded for attempts to access this item. please try again later",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

TRANSACTIONS_LIMIT

Too many requests were made to the /transactions/get endpoint.
Server-Side
Common causes
  • Too many requests were made in a short period of time. Requests to /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 80 requests per Item per minute and 1,000 requests per client per minute.
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 429
{
"error_type": "RATE_LIMIT_EXCEEDED",
"error_code": "TRANSACTIONS_LIMIT",
"error_message": "rate limit exceeded for attempts to access this item. please try again later",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}