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-SideLink 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
.
1http code 4002{3 "error_type": "INSTITUTION_ERROR",4 "error_code": "INSTITUTION_DOWN",5 "error_message": "this institution is not currently responding to this request. please try again soon",6 "display_message": "This financial institution is not currently responding to requests. We apologize for the inconvenience.",7 "request_id": "HNTDNrA8F1shFEW"8}
Was this helpful?
INSTITUTION_NOT_ENABLED_IN_ENVIRONMENT
Institution not enabled in this environment
Server-SideCommon causes
You're referencing an Institution that exists, but is not enabled for this environment (e.g calling a Sandbox endpoint with the ID of an Institution that is not enabled there).
1http code 4002{3 "error_type": "INSTITUTION_ERROR",4 "error_code": "INSTITUTION_NOT_ENABLED_IN_ENVIRONMENT",5 "error_message": "Institution not enabled in this environment",6 "display_message": null,7 "request_id": "HNTDNrA8F1shFEW"8}
Was this helpful?
INSTITUTION_NOT_FOUND
This institution was not found. Please check the ID supplied
Server-Side1http code 4002{3 "error_type": "INSTITUTION_ERROR",4 "error_code": "INSTITUTION_NOT_FOUND",5 "error_message": "this institution was not found. Please check the ID supplied",6 "display_message": null,7 "request_id": "HNTDNrA8F1shFEW"8}
Was this helpful?
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-SideLink 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.
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
.
1http code 4002{3 "error_type": "INSTITUTION_ERROR",4 "error_code": "INSTITUTION_NOT_RESPONDING",5 "error_message": "this institution is not currently responding to this request. please try again soon",6 "display_message": "This financial institution is not currently responding to requests. We apologize for the inconvenience.",7 "request_id": "HNTDNrA8F1shFEW"8}
Was this helpful?
INSTITUTION_NOT_AVAILABLE
The financial institution is not available this time.
Server-SideorClient-SideLink 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
.
1http code 4002{3 "error_type": "INSTITUTION_ERROR",4 "error_code": "INSTITUTION_NOT_AVAILABLE",5 "error_message": "this institution is not currently responding to this request. please try again soon",6 "display_message": "This financial institution is not currently responding to requests. We apologize for the inconvenience.",7 "request_id": "HNTDNrA8F1shFEW"8}
Was this helpful?
INSTITUTION_NO_LONGER_SUPPORTED
Plaid no longer supports this financial institution.
Server-SideorClient-SideCommon causes
- The financial institution is no longer supported on Plaid's platform.
- The institution has switched from supporting non-OAuth-based connections to requiring OAuth-based connections.
1http code 4002{3 "error_type": "INSTITUTION_ERROR",4 "error_code": "INSTITUTION_NO_LONGER_SUPPORTED",5 "error_message": "this institution is no longer supported",6 "display_message": "This financial institution is no longer supported. We apologize for the inconvenience.",7 "request_id": "HNTDNrA8F1shFEW"8}
Was this helpful?
UNAUTHORIZED_INSTITUTION
You are not authorized to create Items for this institution at this time.
Server-SideCommon causes
- Access to this institution is subject to additional verification and must be manually enabled for your account.
Troubleshooting steps
1http code 4002{3 "error_type": "INSTITUTION_ERROR",4 "error_code": "UNAUTHORIZED_INSTITUTION",5 "error_message": "not authorized to create items for this institution",6 "display_message": "You are not authorized to create items for this institution at this time.",7 "request_id": "HNTDNrA8F1shFEW"8}
Was this helpful?
INSTITUTION_REGISTRATION_REQUIRED
Your application is not yet registered with the institution.
Server-SideCommon causes
- Details about your application must be registered with this institution before use.
- If your account has not yet been enabled for Production access, some institutions that require registration may not be available to you.
Troubleshooting steps
1http code 4002{3 "error_type": "INSTITUTION_ERROR",4 "error_code": "INSTITUTION_REGISTRATION_REQUIRED",5 "error_message": "not yet registered to create items for this institution",6 "display_message": "You must register your application with this institution before you can create items for it.",7 "request_id": "HNTDNrA8F1shFEW"8}