Plaid logo
Docs
ALL DOCS

Errors

  • Overview
  • Item errors
  • Institution errors
  • API errors
  • Assets errors
  • Payment errors
  • Virtual Accounts (UK/EU) only
  • Transactions errors
  • Transfer errors
  • Income errors
  • Sandbox errors
  • Invalid Request errors
  • Invalid Input errors
  • Invalid Result errors
  • Rate Limit Exceeded errors
  • Link web errors
  • Recaptcha errors
  • OAuth errors
  • Microdeposits errors
  • Partner errors
Plaid logo
Docs
Plaid.com
Get API keys
Open nav

Link web

Guide to troubleshooting Link errors on the web

Most errors returned by Link are an SDK-specific representation of an API error. For troubleshooting help, see the guidance for the specific API error.

In addition, there is one Link-specific error that does not correspond to an API error:

institution-poor-health-error

The user is trying to link to an institution with poor Plaid connectivity health.
Sample user-facing error message
We're currently experiencing connectivity issues with this bank: You can try again later or find another bank to continue
Link user experience

Your user will see a warning pane before they enter their credentials, telling them that adding the account may fail and suggesting that they link a different account.

Common causes
  • The institution is experiencing a temporary disruption of connectivity to Plaid.
Troubleshooting steps

If the problem persists, file a Plaid support ticket.

Copy
1http code 400
2{
3 "error_type": "",
4 "error_code": "institution-poor-health-error",
5 "error_message": null,
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}
Was this helpful?

oauth-error

Returned when the OAuth login session for a user either times out or errors out
Sample user-facing error message
An error has occurred linking your account:
Link user experience

Your user will be shown an error message indicating that their account was not successfully linked and will be prompted to retry their login attempt.

Common causes
  • Your user did not complete their OAuth login attempt within 10 minutes.
  • Plaid is experiencing internal system issues.
Troubleshooting steps
Copy
1http code 400
2{
3 "error_type": "",
4 "error_code": "oauth-error",
5 "error_message": null,
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}
Was this helpful?
Developer community
GitHub
GitHub
Stack Overflow
Stack Overflow
YouTube
YouTube
Twitter
Twitter
Discord
Discord