Institution Errors

Guide to troubleshooting Institution errors

INSTITUTION_DOWN

The financial institution is down, either for maintenance or due to an infrastructure issue with their systems.
Server-SideorClient-Side
Link user experience

Your user will be redirected to the Institution Select pane to retry connecting their Item or a different account.

Common causes
  • The institution is undergoing scheduled maintenance.
  • The institution is experiencing temporary technical problems.
Troubleshooting steps

If the error persists, please submit a 'Persistent HTTP 500 errors' Support ticket with the following identifiers: access_token, institution_id, and either link_session_id or request_id.

1
2
3
4
5
6
7
8
http code 400 
{
 "error_type": "INSTITUTION_ERROR",
 "error_code": "INSTITUTION_DOWN",
 "error_message": "this institution is not currently responding to this request. please try again soon",
 "display_message": "This financial institution is not currently responding to requests. We apologize for the inconvenience.",
 "request_id": "HNTDNrA8F1shFEW"
}

INSTITUTION_NOT_RESPONDING

The financial institution is failing to respond to some of our requests. Your user may be successful if they retry another time.
Server-SideorClient-Side
Link user experience

Your user will be redirected to the Institution Select pane to retry connecting their Item or a different account.

Common causes
  • The institution is experiencing temporary technical problems.
  • A new Plaid developer is attempting to connect to Bank of America in Production or Development. Access to Bank of America in Development is currently unavailable for developer accounts that have not yet been approved for Production, and access to Bank of America for new developer accounts in Production is temporarily delayed until several days after Production access has been approved. If you require immediate access to Bank of America, contact Support.
Troubleshooting steps

If the error persists, please submit a 'Persistent HTTP 500 errors' Support ticket with the following identifiers: access_token, institution_id, and either link_session_id or request_id.

1
2
3
4
5
6
7
8
http code 400 
{
 "error_type": "INSTITUTION_ERROR",
 "error_code": "INSTITUTION_NOT_RESPONDING",
 "error_message": "this institution is not currently responding to this request. please try again soon",
 "display_message": "This financial institution is not currently responding to requests. We apologize for the inconvenience.",
 "request_id": "HNTDNrA8F1shFEW"
}

INSTITUTION_NOT_AVAILABLE

The financial institution is not available this time.
Server-SideorClient-Side
Link user experience

Your user will be redirected to the Institution Select pane to retry connecting their Item or a different account.

Common causes
  • Plaid’s connection to an institution is temporarily down for maintenance or other planned circumstances.
Troubleshooting steps

If the error persists, please submit a 'Persistent HTTP 500 errors' Support ticket with the following identifiers: access_token, institution_id, and either link_session_id or request_id.

1
2
3
4
5
6
7
8
http code 400 
{
 "error_type": "INSTITUTION_ERROR",
 "error_code": "INSTITUTION_NOT_AVAILABLE",
 "error_message": "this institution is not currently responding to this request. please try again soon",
 "display_message": "This financial institution is not currently responding to requests. We apologize for the inconvenience.",
 "request_id": "HNTDNrA8F1shFEW"
}

INSTITUTION_NO_LONGER_SUPPORTED

Plaid no longer supports this financial institution.
Server-SideorClient-Side
Common causes
  • The financial institution is no longer supported on Plaid's platform.
  • A new Plaid developer is attempting to connect to Bank of America in Production or Development. Access to Bank of America in Development is currently unavailable for developer accounts that have not yet been approved for Production, and access to Bank of America for new developer accounts in Production is temporarily delayed until several days after Production access has been approved. If you require immediate access to Bank of America, contact Support.
  • The institution has switched from supporting non-OAuth-based connections to requiring OAuth-based connections.
1
2
3
4
5
6
7
8
http code 400 
{
 "error_type": "INSTITUTION_ERROR",
 "error_code": "INSTITUTION_NO_LONGER_SUPPORTED",
 "error_message": "this institution is no longer supported",
 "display_message": null,
 "request_id": "HNTDNrA8F1shFEW"
}