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

Endpoint	Max requests per Item	Max requests per client
`/accounts/get`	15 per minute	15,000 per minute
`/asset_report/get`	15 per minute	1,000 per minute
`/auth/get`	15 per minute	12,000 per minute
`/accounts/balance/get`	5 per minute	1,200 per minute
`/identity/get`	15 per minute	2,000 per minute
`/institutions/get`	N/A	25 per minute
`/institutions/get_by_id`	N/A	400 per minute
`/item/get`	15 per minute	5,000 per minute
`/liabilities/get`	15 per minute	1,000 per minute
`/transactions/get`	30 per minute	20,000 per minute
`/transactions/refresh`	2 per minute	100 per minute
`/bank_transfer/create`	5 per day	5,000 per minute

Sandbox rate limits

Endpoint	Max requests per Item	Max requests per client
`/accounts/get`	100 per minute	5,000 per minute
`/asset_report/get`	1,000 per minute	1,000 per minute
`/auth/get`	100 per minute	500 per minute
`/accounts/balance/get`	25 per minute	100 per minute
`/identity/get`	100 per minute	1,000 per minute
`/institutions/get`	N/A	25 per minute
`/institutions/get_by_id`	N/A	400 per minute
`/item/get`	40 per minute	5,000 per minute
`/liabilities/get`	10 per minute	1,000 per minute
`/transactions/get`	80 per minute	1,000 per minute
`/transactions/refresh`	2 per minute	100 per minute
`/bank_transfer/create`	10,000 per day	100 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

Check the activity log in the Dashboard to view a history of all requests made with your API keys and verify that you are not accidentally sending an excessive number of requests to /accounts/get.

If your use case requires a higher rate limit, contact your Account Manager.

API error response
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

Request Development access if you do not already have access to 100 Items. You can request Development access from the Dashboard.

If you already have 100 Items, contact your Plaid Account Manager or Plaid Support to request additional Items in Development.

Test on a different environment, such as Sandbox or Production.

API error response
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

Check the activity log in the Dashboard to view a history of all requests made with your API keys and verify that you are not accidentally sending an excessive number of requests to /auth/get.

If your use case requires a higher rate limit, contact your Account Manager.

API error response
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

Check the activity log in the Dashboard to view a history of all requests made with your API keys and verify that you are not accidentally sending an excessive number of requests to /accounts/balance/get.

If your use case requires a higher rate limit, contact your Account Manager.

API error response
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

Check the activity log in the Dashboard to view a history of all requests made with your API keys and verify that you are not accidentally sending an excessive number of requests to /identity/get.

If your use case requires a higher rate limit, contact your Account Manager.

API error response
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

Check the activity log in the Dashboard to view a history of all requests made with your API keys and verify that you are not accidentally sending an excessive number of requests to /item/get.

If your use case requires a higher rate limit, contact your Account Manager.

API error response
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

Check the activity log in the Dashboard to view a history of all requests made with your API keys and verify that you are not accidentally sending an excessive number of requests to a Plaid endpoint.

Verify that you are not using Sandbox credentials in a non-Sandbox environment, such as Development or Production.

If your use case requires a higher rate limit, contact your Account Manager.

API error response
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

If your use case requires a higher rate limit, contact your Account Manager.

API error response
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"
}

Rate Limit Exceeded Errors

Guide to troubleshooting rate limit exceeded errors

Rate limit table

Production and Development rate limits

Sandbox rate limits

ACCOUNTS_LIMIT

Too many requests were made to the /accounts/get endpoint.

Common causes

Troubleshooting steps

ADDITION_LIMIT

You have exceeded your addition limit in our Development environment. To increase it, or raise it from zero, contact us.

Common causes

Troubleshooting steps

AUTH_LIMIT

Too many requests were made to the /auth/get endpoint.

Common causes

Troubleshooting steps

BALANCE_LIMIT

Too many requests were made to the /accounts/balance/get endpoint.

Common causes

Troubleshooting steps

IDENTITY_LIMIT

Too many requests were made to the /identity/get endpoint.

Common causes

Troubleshooting steps

ITEM_GET_LIMIT

Too many requests were made to the /item/get endpoint.

Common causes

Troubleshooting steps

RATE_LIMIT

Too many requests were made.

Common causes

Troubleshooting steps

TRANSACTIONS_LIMIT

Too many requests were made to the /transactions/get endpoint.

Common causes

Troubleshooting steps