Errors

A comprehensive breakdown of all Plaid client and server-side errors

Errors overview

Item errors Occur when an Item may be invalid or not supported on Plaid's platform.	INVALID_CREDENTIALS INVALID_MFA OTP Device & Code INVALID_MFA Questions INVALID_MFA Selections ITEM_LOGIN_REQUIRED INSUFFICIENT_CREDENTIALS ITEM_LOCKED MFA_NOT_SUPPORTED INVALID_SEND_METHOD NO_ACCOUNTS ITEM_NOT_SUPPORTED INSTANT_MATCH_FAILED INVALID_UPDATED_USERNAME ITEM_NO_ERROR or item-no-error NO_AUTH_ACCOUNTS or no-depository-accounts NO_INVESTMENT_ACCOUNTS NO_INVESTMENT_AUTH_ACCOUNTS NO_LIABILITY_ACCOUNTS PRODUCTS_NOT_SUPPORTED ITEM_NOT_FOUND PRODUCT_NOT_ENABLED PRODUCT_NOT_READY ACCESS_NOT_GRANTED
Institution errors Occur when there are errors for the requested financial institution.	INSTITUTION_DOWN INSTITUTION_NOT_AVAILABLE INSTITUTION_NOT_ENABLED_IN_ENVIRONMENT INSTITUTION_NOT_FOUND INSTITUTION_NOT_RESPONDING INSTITUTION_NO_LONGER_SUPPORTED INSTITUTION_REGISTRATION_REQUIRED UNAUTHORIZED_INSTITUTION
API errors Occur during planned maintenance and in response to API errors.	INTERNAL_SERVER_ERROR or plaid-internal-error PLANNED_MAINTENANCE
Assets errors Occur for errors related to Asset endpoints.	PRODUCT_NOT_ENABLED DATA_UNAVAILABLE PRODUCT_NOT_READY ASSET_REPORT_GENERATION_FAILED INVALID_PARENT INSIGHTS_NOT_ENABLED INSIGHTS_PREVIOUSLY_NOT_ENABLED
Payment errors Occur for errors related to Payment Initiation endpoints.	PAYMENT_BLOCKED PAYMENT_INSUFFICIENT_FUNDS PAYMENT_INVALID_RECIPIENT PAYMENT_INVALID_REFERENCE PAYMENT_INVALID_SCHEDULE
Bank Transfers errors Occur for errors related to Bank Transfers endpoints.	BANK_TRANSFER_LIMIT_EXCEEDED BANK_TRANSFER_MISSING_ORIGINATION_AMOUNT BANK_TRANSFER_INVALID_ORIGINATION_AMOUNT BANK_TRANSFER_ACCOUNT_BLOCKED BANK_TRANSFER_INSUFFICIENT_FUNDS BANK_TRANSFER_NOT_CANCELLABLE BANK_TRANSFER_UNSUPPORTED_ACCOUNT_TYPE BANK_TRANSFER_UNSUPPORTED_ENVIRONMENT BANK_TRANSFER_FORBIDDEN_ACH_CLASS
Deposit Switch errors Occur for errors related to Deposit Switch endpoints.	INVALID_DEPOSIT_SWITCH_ID DEPOSIT_SWITCH_NOT_FOUND DEPOSIT_SWITCH_TOKEN_NOT_FOUND DEPOSIT_SWITCH_INVALID_ACCOUNT DEPOSIT_SWITCH_VALID_AUTH_NOT_FOUND DEPOSIT_SWITCH_VALID_IDENTITY_NOT_FOUND DEPOSIT_SWITCH_ALREADY_COMPLETED
Sandbox errors Occur when invalid parameters are supplied in the Sandbox environment.	SANDBOX_PRODUCT_NOT_ENABLED SANDBOX_WEBHOOK_INVALID SANDBOX_BANK_TRANSFER_EVENT_TRANSITION_INVALID
Invalid Request errors Occur when a request is malformed and cannot be processed.	MISSING_FIELDS UNKNOWN_FIELDS INVALID_FIELD INVALID_CONFIGURATION INCOMPATIBLE_API_VERSION INVALID_BODY INVALID_HEADERS NOT_FOUND NO_LONGER_AVAILABLE SANDBOX_ONLY INVALID_ACCOUNT_NUMBER
Invalid Input errors Occur when all fields are provided, but the values provided are incorrect in some way.	TOO_MANY_VERIFICATION_ATTEMPTS INCORRECT_DEPOSIT_AMOUNTS UNAUTHORIZED_ENVIRONMENT INVALID_PRODUCT USER_PERMISSION_REVOKED UNAUTHORIZED_ROUTE_ACCESS DIRECT_INTEGRATION_NOT_ENABLED INVALID_API_KEYS INVALID_ACCESS_TOKEN INVALID_PUBLIC_TOKEN INVALID_LINK_TOKEN INVALID_PROCESSOR_TOKEN INVALID_AUDIT_COPY_TOKEN INVALID_ACCOUNT_ID INVALID_STRIPE_ACCOUNT INVALID_INSTITUTION INVALID_CREDENTIAL_FIELDS INVALID_PRODUCTS PRODUCT_UNAVAILABLE INVALID_WEBHOOK_VERIFICATION_KEY_ID
Invalid Result errors Occur when a request is valid, but the output would be unusable for any supported flow.	PLAID_DIRECT_ITEM_IMPORT_RETURNED_INVALID_MFA
Rate Limit Exceeded errors Occur when an excessive number of requests are made in a short period of time.	ACCOUNTS_LIMIT ADDITION_LIMIT AUTH_LIMIT BALANCE_LIMIT IDENTITY_LIMIT ITEM_GET_LIMIT RATE_LIMIT TRANSACTIONS_LIMIT
Link Web errors Occur when the error is specific to Link on the web platform.	institution-poor-health-error oauth-error
ReCAPTCHA errors Occur when a Recaptcha challenge has been presented or failed during the link process.	RECAPTCHA_REQUIRED RECAPTCHA_BAD
OAuth errors Occur when there is an error in OAuth authentication.	INCORRECT_OAUTH_NONCE INCORRECT_LINK_TOKEN OAUTH_STATE_ID_ALREADY_PROCESSED

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.

error_typestring

A broad categorization of the error. Safe for programatic use.

Possible values: INVALID_REQUEST, INVALID_RESULT, INVALID_INPUT, INSTITUTION_ERROR, RATE_LIMIT_EXCEEDED, API_ERROR, ITEM_ERROR, ASSET_REPORT_ERROR, RECAPTCHA_ERROR, OAUTH_ERROR, PAYMENT_ERROR, BANK_TRANSFER_ERROR

error_codestring

The particular error code. Safe for programmatic use.

error_messagestring

A developer-friendly representation of the error code. This may change over time and is not safe for programmatic use.

display_messagestring

A user-friendly representation of the error code. null if the error is not related to user action.
This may change over time and is not safe for programmatic use.

request_idstring

A unique identifying the request, to be used for troubleshooting purposes. This field will be omitted in errors provided by webhooks.

causesarray

In the Assets product, a request can pertain to more than one Item. If an error is returned for such a request, causes will return an array of errors containing a breakdown of these errors on the individual Item level, if any can be identified.
causes will only be provided for the error_type ASSET_REPORT_ERROR.

statusnumber

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.

documentation_urlstring

The URL of a Plaid documentation page with more information about the error

suggested_actionstring

Suggested steps for resolving the error

Errors

A comprehensive breakdown of all Plaid client and server-side errors

Errors overview

Error schema