A comprehensive breakdown of all Plaid error codes
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.
Virtual Account errors
Occur for errors related to Virtual Account endpoints.
Occur for errors related to Transactions endpoints.
Occur for errors related to Transfer endpoints.
Occur for errors related to Income 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.
Occur when there is an error with micro-deposits.
Occur when there is an error with creating or managing end customers.
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. An Item with a non-
null error object will only be part of an API response when calling
/item/get to view Item status. Otherwise, error fields will be
null if no error has occurred; if an error has occurred, an error code will be returned instead.
nullif the error is not related to user action.
This may change over time and is not safe for programmatic use.
causeswill return an array of errors containing a breakdown of these errors on the individual Item level, if any can be identified.
causeswill only be provided for the
causeswill also not be populated inside an error nested within a