A comprehensive breakdown of all Plaid client and server-side errors
Occur when an Item may be invalid or not supported on Plaid's platform.
OTP Device & Code
Occur when there are errors for the requested financial institution.
Occur during planned maintenance and in response to API errors.
Occur for errors related to Asset endpoints.
Occur for errors related to Payment Initiation endpoints.
Bank Transfers errors
Occur for errors related to Bank Transfers endpoints.
Deposit Switch errors
Occur for errors related to Deposit Switch endpoints.
Occur when invalid parameters are supplied in the Sandbox environment.
Invalid Request errors
Occur when a request is malformed and cannot be processed.
Invalid Input errors
Occur when all fields are provided, but the values provided are incorrect in some way.
Invalid Result errors
Occur when a request is valid, but the output would be unusable for any supported flow.
Rate Limit Exceeded errors
Occur when an excessive number of requests are made in a short period of time.
Link Web errors
Occur when the error is specific to Link on the web platform.
Occur when a Recaptcha challenge has been presented or failed during the link process.
Occur when there is an error in OAuth authentication.
We use standard HTTP response codes for success and failure notifications, and our errors are further classified by
error_type. In general, 200 HTTP codes correspond to success, 40X codes are for developer- or user-related failures, and 50X codes are for Plaid-related issues. Error fields will be
null if no error has occurred.
A broad categorization of the error. Safe for programatic use.
The particular error code. Safe for programmatic use.
A developer-friendly representation of the error code. This may change over time and is not safe for programmatic use.
A user-friendly representation of the error code.
This may change over time and is not safe for programmatic use.
A unique identifying the request, to be used for troubleshooting purposes. This field will be omitted in errors provided by webhooks.
In the Assets product, a request can pertain to more than one Item. If an error is returned for such a request,
The HTTP status code associated with the error. This will only be returned in the response body when the error information is provided via a webhook.
The URL of a Plaid documentation page with more information about the error
Suggested steps for resolving the error