Plaid logo
Docs
ALL DOCS

API

  • Overview
  • Libraries
  • API versioning
  • Postman Collection
  • Webhooks
Product API reference
  • Transactions
  • Auth
  • Balance
  • Identity
  • Assets
  • Investments
  • Liabilities
  • Payment Initiation
  • Virtual Accounts
  • Transfer (beta)
  • Income
  • Identity Verification
  • Monitor
  • Signal
  • Enrich
Other API reference
  • Item endpoints and webhooks
  • Account endpoints and schemas
  • Institution endpoints
  • Token flow and endpoints
  • Processor endpoints
  • Sandbox endpoints
  • Reseller partner endpoints
Plaid logo
Docs
Plaid.com
Get API keys
Open nav

Institutions endpoints

Fetch data about supported institutions

The interface for these endpoints has changed in a recent API release. If you are using an API version prior to 2020-09-14, see API versioning.

Introduction

Institutions endpoints support querying all institutions, as well as looking up a single institution to retrieve up-to-date information about its health status and capabilities. This can be useful for apps whose business logic may depend on institution capabilities, such as Payment Initiation. API-provided institution health data can also be used for in-app UIs. For example, Personal Financial Management (PFM) apps can help set user expectations around data availability by showing dashboard data displaying the health of a user's connected institutions, in conjunction with personalized Item last updated data from /item/get.

For non-programmatic access to institution information, the status dashboard provides a browsable view of institutions, supported products, and institution health.

Institution coverage

To see which institutions are supported, or to look up the status of a specific institution, use the Institution status dashboard. You can also query this information programmatically via the /institutions/get and /institutions/search endpoints.

Plaid supports over 12,000 institutions across North America and Europe.

By default, you receive access to institutions in all countries in Sandbox and Development, and to United States and Canada in Production. To gain access to additional countries in Production, file a product access Support ticket.

For a list of which products are supported for each country, see Global coverage.

Endpoints
/institutions/getGet a list of all supported institutions
/institutions/get_by_idGet details about a specific institution
/institutions/searchLook up an institution by name

/institutions/get

Get details of all supported institutions

Returns a JSON response containing details on all financial institutions currently supported by Plaid. Because Plaid supports thousands of institutions, results are paginated.
If there is no overlap between an institution’s enabled products and a client’s enabled products, then the institution will be filtered out from the response. As a result, the number of institutions returned may not match the count specified in the call.

institutions/get

Request fields and example

client_id
string
Your Plaid API client_id. The client_id is required and may be provided either in the PLAID-CLIENT-ID header or as part of a request body.
secret
string
Your Plaid API secret. The secret is required and may be provided either in the PLAID-SECRET header or as part of a request body.
count
requiredinteger
The total number of Institutions to return.

Minimum: 1
Maximum: 500
offset
requiredinteger
The number of Institutions to skip.

Minimum: 0
country_codes
required[string]
Specify an array of Plaid-supported country codes this institution supports, using the ISO-3166-1 alpha-2 country code standard.
In API versions 2019-05-29 and earlier, the country_codes parameter is an optional parameter within the options object and will default to [US] if it is not supplied.


Min items: 1
Possible values: US, GB, ES, NL, FR, IE, CA, DE, IT, PL, DK, NO, SE, EE, LT, LV
options
object
An optional object to filter /institutions/get results.
products
[string]
Filter the Institutions based on which products they support.

Min items: 1
Possible values: assets, auth, balance, employment, identity, income_verification, identity_verification, investments, liabilities, payment_initiation, standing_orders, transactions, transfer
routing_numbers
[string]
Specify an array of routing numbers to filter institutions. The response will only return institutions that match all of the routing numbers in the array. Routing number records used for this matching are not comprehensive; failure to match a given routing number to an institution does not mean that the institution is unsupported by Plaid.
oauth
boolean
Limit results to institutions with or without mandatory OAuth login flows. Note that institutions will only have oauth set to true if all Items associated with that institution are required to use OAuth flows; institutions in a state of migration to OAuth may have the oauth attribute set to false even if they support OAuth.
include_optional_metadata
boolean
When true, return the institution's homepage URL, logo and primary brand color.
Note that Plaid does not own any of the logos shared by the API, and that by accessing or using these logos, you agree that you are doing so at your own risk and will, if necessary, obtain all required permissions from the appropriate rights holders and adhere to any applicable usage guidelines. Plaid disclaims all express or implied warranties with respect to the logos.
include_auth_metadata
boolean
When true, returns metadata related to the Auth product indicating which auth methods are supported.

Default: false
include_payment_initiation_metadata
boolean
When true, returns metadata related to the Payment Initiation product indicating which payment configurations are supported.

Default: false
Select group for content switcher
Select Language
Copy
1// Pull institutions
2const request: InstitutionsGetRequest = {
3 count: 10,
4 offset: 0,
5 country_codes: ['US'],
6};
7try {
8 const response = await plaidClient.institutionsGet(request);
9 const institutions = response.data.institutions;
10} catch (error) {
11 // Handle error
12}
institutions/get

Response fields and example

institutions
[object]
A list of Plaid institutions
institution_id
string
Unique identifier for the institution
name
string
The official name of the institution
products
[string]
A list of the Plaid products supported by the institution. Note that only institutions that support Instant Auth will return auth in the product array; institutions that do not list auth may still support other Auth methods such as Instant Match or Automated Micro-deposit Verification. To identify institutions that support those methods, use the auth_metadata object. For more details, see Full Auth coverage.

Possible values: assets, auth, balance, identity, investments, liabilities, payment_initiation, identity_verification, transactions, credit_details, income, income_verification, deposit_switch, standing_orders, transfer, employment, recurring_transactions
country_codes
[string]
A list of the country codes supported by the institution.

Possible values: US, GB, ES, NL, FR, IE, CA, DE, IT, PL, DK, NO, SE, EE, LT, LV
url
nullablestring
The URL for the institution's website
primary_color
nullablestring
Hexadecimal representation of the primary color used by the institution
logo
nullablestring
Base64 encoded representation of the institution's logo
routing_numbers
[string]
A partial list of routing numbers associated with the institution. This list is provided for the purpose of looking up institutions by routing number. It is not comprehensive and should never be used as a complete list of routing numbers for an institution.
oauth
boolean
Indicates that the institution has a mandatory OAuth login flow. Note that oauth may be false even for institutions that support OAuth, if the institution is in the process of migrating to OAuth and some active Items still exist that do not use OAuth.
status
nullableobject
The status of an institution is determined by the health of its Item logins, Transactions updates, Investments updates, Liabilities updates, Auth requests, Balance requests, Identity requests, Investments requests, and Liabilities requests. A login attempt is conducted during the initial Item add in Link. If there is not enough traffic to accurately calculate an institution's status, Plaid will return null rather than potentially inaccurate data.
Institution status is accessible in the Dashboard and via the API using the /institutions/get_by_id endpoint with the include_status option set to true. Note that institution status is not available in the Sandbox environment.
item_logins
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
transactions_updates
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
auth
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
identity
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
investments_updates
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
liabilities_updates
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
liabilities
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
investments
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
health_incidents
nullable[object]
Details of recent health incidents associated with the institution.
start_date
string
The start date of the incident, in ISO 8601 format, e.g. "2020-10-30T15:26:48Z".

Format: date-time
end_date
nullablestring
The end date of the incident, in ISO 8601 format, e.g. "2020-10-30T15:26:48Z".

Format: date-time
title
string
The title of the incident
incident_updates
[object]
Updates on the health incident.
description
string
The content of the update.
status
string
The status of the incident.

Possible values: INVESTIGATING, IDENTIFIED, SCHEDULED, RESOLVED, UNKNOWN
updated_date
string
The date when the update was published, in ISO 8601 format, e.g. "2020-10-30T15:26:48Z".

Format: date-time
payment_initiation_metadata
nullableobject
Metadata that captures what specific payment configurations an institution supports when making Payment Initiation requests.
supports_international_payments
boolean
Indicates whether the institution supports payments from a different country.
supports_sepa_instant
boolean
Indicates whether the institution supports SEPA Instant payments.
maximum_payment_amount
object
A mapping of currency to maximum payment amount (denominated in the smallest unit of currency) supported by the institution.
Example: {"GBP": "10000"}
supports_refund_details
boolean
Indicates whether the institution supports returning refund details when initiating a payment.
standing_order_metadata
nullableobject
Metadata specifically related to valid Payment Initiation standing order configurations for the institution.
supports_standing_order_end_date
boolean
Indicates whether the institution supports closed-ended standing orders by providing an end date.
supports_standing_order_negative_execution_days
boolean
This is only applicable to MONTHLY standing orders. Indicates whether the institution supports negative integers (-1 to -5) for setting up a MONTHLY standing order relative to the end of the month.
valid_standing_order_intervals
[string]
A list of the valid standing order intervals supported by the institution.

Possible values: WEEKLY, MONTHLY
Min length: 1
auth_metadata
nullableobject
Metadata that captures information about the Auth features of an institution.
supported_methods
nullableobject
Metadata specifically related to which auth methods an institution supports.
instant_auth
boolean
Indicates if instant auth is supported.
instant_match
boolean
Indicates if instant match is supported.
automated_micro_deposits
boolean
Indicates if automated microdeposits are supported.
total
integer
The total number of institutions available via this endpoint
request_id
string
A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.
Copy
1{
2 "institutions": [
3 {
4 "country_codes": [
5 "US"
6 ],
7 "institution_id": "ins_1",
8 "name": "Bank of America",
9 "products": [
10 "assets",
11 "auth",
12 "balance",
13 "transactions",
14 "identity",
15 "liabilities"
16 ],
17 "routing_numbers": [
18 "011000138",
19 "011200365",
20 "011400495"
21 ],
22 "oauth": false,
23 "status": {
24 "item_logins": {
25 "status": "HEALTHY",
26 "last_status_change": "2019-02-15T15:53:00Z",
27 "breakdown": {
28 "success": 0.9,
29 "error_plaid": 0.01,
30 "error_institution": 0.09
31 }
32 },
33 "transactions_updates": {
34 "status": "HEALTHY",
35 "last_status_change": "2019-02-12T08:22:00Z",
36 "breakdown": {
37 "success": 0.95,
38 "error_plaid": 0.02,
39 "error_institution": 0.03,
40 "refresh_interval": "NORMAL"
41 }
42 },
43 "auth": {
44 "status": "HEALTHY",
45 "last_status_change": "2019-02-15T15:53:00Z",
46 "breakdown": {
47 "success": 0.91,
48 "error_plaid": 0.01,
49 "error_institution": 0.08
50 }
51 },
52 "identity": {
53 "status": "DEGRADED",
54 "last_status_change": "2019-02-15T15:50:00Z",
55 "breakdown": {
56 "success": 0.42,
57 "error_plaid": 0.08,
58 "error_institution": 0.5
59 }
60 },
61 "investments": {
62 "status": "HEALTHY",
63 "last_status_change": "2019-02-15T15:53:00Z",
64 "breakdown": {
65 "success": 0.89,
66 "error_plaid": 0.02,
67 "error_institution": 0.09
68 },
69 "liabilities": {
70 "status": "HEALTHY",
71 "last_status_change": "2019-02-15T15:53:00Z",
72 "breakdown": {
73 "success": 0.89,
74 "error_plaid": 0.02,
75 "error_institution": 0.09
76 }
77 }
78 },
79 "investments_updates": {
80 "status": "HEALTHY",
81 "last_status_change": "2019-02-12T08:22:00Z",
82 "breakdown": {
83 "success": 0.95,
84 "error_plaid": 0.02,
85 "error_institution": 0.03,
86 "refresh_interval": "NORMAL"
87 }
88 },
89 "liabilities_updates": {
90 "status": "HEALTHY",
91 "last_status_change": "2019-02-12T08:22:00Z",
92 "breakdown": {
93 "success": 0.95,
94 "error_plaid": 0.02,
95 "error_institution": 0.03,
96 "refresh_interval": "NORMAL"
97 }
98 }
99 }
100 }
101 ],
102 "request_id": "tbFyCEqkU774ZGG",
103 "total": 11384
104}
Was this helpful?

/institutions/get_by_id

Get details of an institution

Returns a JSON response containing details on a specified financial institution currently supported by Plaid.
Versioning note: API versions 2019-05-29 and earlier allow use of the public_key parameter instead of the client_id and secret to authenticate to this endpoint. The public_key has been deprecated; all customers are encouraged to use client_id and secret instead.

institutions/get_by_id

Request fields and example

client_id
string
Your Plaid API client_id. The client_id is required and may be provided either in the PLAID-CLIENT-ID header or as part of a request body.
secret
string
Your Plaid API secret. The secret is required and may be provided either in the PLAID-SECRET header or as part of a request body.
institution_id
requiredstring
The ID of the institution to get details about

Min length: 1
country_codes
required[string]
Specify an array of Plaid-supported country codes this institution supports, using the ISO-3166-1 alpha-2 country code standard. In API versions 2019-05-29 and earlier, the country_codes parameter is an optional parameter within the options object and will default to [US] if it is not supplied.

Possible values: US, GB, ES, NL, FR, IE, CA, DE, IT, PL, DK, NO, SE, EE, LT, LV
options
object
Specifies optional parameters for /institutions/get_by_id. If provided, must not be null.
include_optional_metadata
boolean
When true, return an institution's logo, brand color, and URL. When available, the bank's logo is returned as a base64 encoded 152x152 PNG, the brand color is in hexadecimal format. The default value is false.
Note that Plaid does not own any of the logos shared by the API and that by accessing or using these logos, you agree that you are doing so at your own risk and will, if necessary, obtain all required permissions from the appropriate rights holders and adhere to any applicable usage guidelines. Plaid disclaims all express or implied warranties with respect to the logos.


Default: false
include_status
boolean
If true, the response will include status information about the institution. Default value is false.

Default: false
include_auth_metadata
boolean
When true, returns metadata related to the Auth product indicating which auth methods are supported.

Default: false
include_payment_initiation_metadata
boolean
When true, returns metadata related to the Payment Initiation product indicating which payment configurations are supported.

Default: false
Select group for content switcher
Select Language
Copy
1const request: InstitutionsGetByIdRequest = {
2 institution_id: institutionID,
3 country_codes: ['US'],
4};
5try {
6 const response = await plaidClient.institutionsGetById(request);
7 const institution = response.data.institution;
8} catch (error) {
9 // Handle error
10}
institutions/get_by_id

Response fields and example

institution
object
Details relating to a specific financial institution
institution_id
string
Unique identifier for the institution
name
string
The official name of the institution
products
[string]
A list of the Plaid products supported by the institution. Note that only institutions that support Instant Auth will return auth in the product array; institutions that do not list auth may still support other Auth methods such as Instant Match or Automated Micro-deposit Verification. To identify institutions that support those methods, use the auth_metadata object. For more details, see Full Auth coverage.

Possible values: assets, auth, balance, identity, investments, liabilities, payment_initiation, identity_verification, transactions, credit_details, income, income_verification, deposit_switch, standing_orders, transfer, employment, recurring_transactions
country_codes
[string]
A list of the country codes supported by the institution.

Possible values: US, GB, ES, NL, FR, IE, CA, DE, IT, PL, DK, NO, SE, EE, LT, LV
url
nullablestring
The URL for the institution's website
primary_color
nullablestring
Hexadecimal representation of the primary color used by the institution
logo
nullablestring
Base64 encoded representation of the institution's logo
routing_numbers
[string]
A partial list of routing numbers associated with the institution. This list is provided for the purpose of looking up institutions by routing number. It is not comprehensive and should never be used as a complete list of routing numbers for an institution.
oauth
boolean
Indicates that the institution has a mandatory OAuth login flow. Note that oauth may be false even for institutions that support OAuth, if the institution is in the process of migrating to OAuth and some active Items still exist that do not use OAuth.
status
nullableobject
The status of an institution is determined by the health of its Item logins, Transactions updates, Investments updates, Liabilities updates, Auth requests, Balance requests, Identity requests, Investments requests, and Liabilities requests. A login attempt is conducted during the initial Item add in Link. If there is not enough traffic to accurately calculate an institution's status, Plaid will return null rather than potentially inaccurate data.
Institution status is accessible in the Dashboard and via the API using the /institutions/get_by_id endpoint with the include_status option set to true. Note that institution status is not available in the Sandbox environment.
item_logins
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
transactions_updates
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
auth
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
identity
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
investments_updates
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
liabilities_updates
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
liabilities
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
investments
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
health_incidents
nullable[object]
Details of recent health incidents associated with the institution.
start_date
string
The start date of the incident, in ISO 8601 format, e.g. "2020-10-30T15:26:48Z".

Format: date-time
end_date
nullablestring
The end date of the incident, in ISO 8601 format, e.g. "2020-10-30T15:26:48Z".

Format: date-time
title
string
The title of the incident
incident_updates
[object]
Updates on the health incident.
description
string
The content of the update.
status
string
The status of the incident.

Possible values: INVESTIGATING, IDENTIFIED, SCHEDULED, RESOLVED, UNKNOWN
updated_date
string
The date when the update was published, in ISO 8601 format, e.g. "2020-10-30T15:26:48Z".

Format: date-time
payment_initiation_metadata
nullableobject
Metadata that captures what specific payment configurations an institution supports when making Payment Initiation requests.
supports_international_payments
boolean
Indicates whether the institution supports payments from a different country.
supports_sepa_instant
boolean
Indicates whether the institution supports SEPA Instant payments.
maximum_payment_amount
object
A mapping of currency to maximum payment amount (denominated in the smallest unit of currency) supported by the institution.
Example: {"GBP": "10000"}
supports_refund_details
boolean
Indicates whether the institution supports returning refund details when initiating a payment.
standing_order_metadata
nullableobject
Metadata specifically related to valid Payment Initiation standing order configurations for the institution.
supports_standing_order_end_date
boolean
Indicates whether the institution supports closed-ended standing orders by providing an end date.
supports_standing_order_negative_execution_days
boolean
This is only applicable to MONTHLY standing orders. Indicates whether the institution supports negative integers (-1 to -5) for setting up a MONTHLY standing order relative to the end of the month.
valid_standing_order_intervals
[string]
A list of the valid standing order intervals supported by the institution.

Possible values: WEEKLY, MONTHLY
Min length: 1
auth_metadata
nullableobject
Metadata that captures information about the Auth features of an institution.
supported_methods
nullableobject
Metadata specifically related to which auth methods an institution supports.
instant_auth
boolean
Indicates if instant auth is supported.
instant_match
boolean
Indicates if instant match is supported.
automated_micro_deposits
boolean
Indicates if automated microdeposits are supported.
request_id
string
A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.
Copy
1{
2 "institution": {
3 "country_codes": [
4 "US"
5 ],
6 "institution_id": "ins_109512",
7 "name": "Houndstooth Bank",
8 "products": [
9 "auth",
10 "balance",
11 "identity",
12 "transactions"
13 ],
14 "routing_numbers": [
15 "011000138",
16 "011200365",
17 "011400495"
18 ],
19 "oauth": false,
20 "status": {
21 "item_logins": {
22 "status": "HEALTHY",
23 "last_status_change": "2019-02-15T15:53:00Z",
24 "breakdown": {
25 "success": 0.9,
26 "error_plaid": 0.01,
27 "error_institution": 0.09
28 }
29 },
30 "transactions_updates": {
31 "status": "HEALTHY",
32 "last_status_change": "2019-02-12T08:22:00Z",
33 "breakdown": {
34 "success": 0.95,
35 "error_plaid": 0.02,
36 "error_institution": 0.03,
37 "refresh_interval": "NORMAL"
38 }
39 },
40 "auth": {
41 "status": "HEALTHY",
42 "last_status_change": "2019-02-15T15:53:00Z",
43 "breakdown": {
44 "success": 0.91,
45 "error_plaid": 0.01,
46 "error_institution": 0.08
47 }
48 },
49 "identity": {
50 "status": "DEGRADED",
51 "last_status_change": "2019-02-15T15:50:00Z",
52 "breakdown": {
53 "success": 0.42,
54 "error_plaid": 0.08,
55 "error_institution": 0.5
56 }
57 },
58 "investments": {
59 "status": "HEALTHY",
60 "last_status_change": "2019-02-15T15:53:00Z",
61 "breakdown": {
62 "success": 0.89,
63 "error_plaid": 0.02,
64 "error_institution": 0.09
65 },
66 "liabilities": {
67 "status": "HEALTHY",
68 "last_status_change": "2019-02-15T15:53:00Z",
69 "breakdown": {
70 "success": 0.89,
71 "error_plaid": 0.02,
72 "error_institution": 0.09
73 }
74 }
75 },
76 "investments_updates": {
77 "status": "HEALTHY",
78 "last_status_change": "2019-02-12T08:22:00Z",
79 "breakdown": {
80 "success": 0.95,
81 "error_plaid": 0.02,
82 "error_institution": 0.03,
83 "refresh_interval": "NORMAL"
84 }
85 },
86 "liabilities_updates": {
87 "status": "HEALTHY",
88 "last_status_change": "2019-02-12T08:22:00Z",
89 "breakdown": {
90 "success": 0.95,
91 "error_plaid": 0.02,
92 "error_institution": 0.03,
93 "refresh_interval": "NORMAL"
94 }
95 }
96 },
97 "primary_color": "#004966",
98 "url": "https://plaid.com",
99 "logo": null
100 },
101 "request_id": "m8MDnv9okwxFNBV"
102}
Was this helpful?

/institutions/search

Search institutions

Returns a JSON response containing details for institutions that match the query parameters, up to a maximum of ten institutions per query.
Versioning note: API versions 2019-05-29 and earlier allow use of the public_key parameter instead of the client_id and secret parameters to authenticate to this endpoint. The public_key parameter has since been deprecated; all customers are encouraged to use client_id and secret instead.

institutions/search

Request fields and example

client_id
string
Your Plaid API client_id. The client_id is required and may be provided either in the PLAID-CLIENT-ID header or as part of a request body.
secret
string
Your Plaid API secret. The secret is required and may be provided either in the PLAID-SECRET header or as part of a request body.
query
requiredstring
The search query. Institutions with names matching the query are returned

Min length: 1
products
required[string]
Filter the Institutions based on whether they support all products listed in products. Provide null to get institutions regardless of supported products. Note that when auth is specified as a product, if you are enabled for Instant Match or Automated Micro-deposits, institutions that support those products will be returned even if auth is not present in their product array.

Min items: 1
Possible values: assets, auth, balance, employment, identity, income_verification, investments, liabilities, identity_verification, payment_initiation, standing_orders, transactions, transfer
country_codes
required[string]
Specify an array of Plaid-supported country codes this institution supports, using the ISO-3166-1 alpha-2 country code standard. In API versions 2019-05-29 and earlier, the country_codes parameter is an optional parameter within the options object and will default to [US] if it is not supplied.

Possible values: US, GB, ES, NL, FR, IE, CA, DE, IT, PL, DK, NO, SE, EE, LT, LV
options
object
An optional object to filter /institutions/search results.
oauth
boolean
Limit results to institutions with or without mandatory OAuth login flows. Note that institutions will only have oauth set to true if all Items associated with that institution are required to use OAuth flows; institutions in a state of migration to OAuth may have the oauth attribute set to false even if they support OAuth.
include_optional_metadata
boolean
When true, return the institution's homepage URL, logo and primary brand color.
include_auth_metadata
boolean
When true, returns metadata related to the Auth product indicating which auth methods are supported.

Default: false
include_payment_initiation_metadata
boolean
When true, returns metadata related to the Payment Initiation product indicating which payment configurations are supported.

Default: false
payment_initiation
object
Additional options that will be used to filter institutions by various Payment Initiation configurations.
payment_id
string
A unique ID identifying the payment
consent_id
string
A unique ID identifying the payment consent
Select group for content switcher
Select Language
Copy
1const request: InstitutionsSearchRequest = {
2 query: institutionID,
3 products: ['transactions'],
4 country_codes: ['US'],
5};
6try {
7 const response = await plaidClient.institutionsSearch(request);
8 const institutions = response.data.institutions;
9} catch (error) {
10 // Handle error
11}
institutions/search

Response fields and example

institutions
[object]
An array of institutions matching the search criteria
institution_id
string
Unique identifier for the institution
name
string
The official name of the institution
products
[string]
A list of the Plaid products supported by the institution. Note that only institutions that support Instant Auth will return auth in the product array; institutions that do not list auth may still support other Auth methods such as Instant Match or Automated Micro-deposit Verification. To identify institutions that support those methods, use the auth_metadata object. For more details, see Full Auth coverage.

Possible values: assets, auth, balance, identity, investments, liabilities, payment_initiation, identity_verification, transactions, credit_details, income, income_verification, deposit_switch, standing_orders, transfer, employment, recurring_transactions
country_codes
[string]
A list of the country codes supported by the institution.

Possible values: US, GB, ES, NL, FR, IE, CA, DE, IT, PL, DK, NO, SE, EE, LT, LV
url
nullablestring
The URL for the institution's website
primary_color
nullablestring
Hexadecimal representation of the primary color used by the institution
logo
nullablestring
Base64 encoded representation of the institution's logo
routing_numbers
[string]
A partial list of routing numbers associated with the institution. This list is provided for the purpose of looking up institutions by routing number. It is not comprehensive and should never be used as a complete list of routing numbers for an institution.
oauth
boolean
Indicates that the institution has a mandatory OAuth login flow. Note that oauth may be false even for institutions that support OAuth, if the institution is in the process of migrating to OAuth and some active Items still exist that do not use OAuth.
status
nullableobject
The status of an institution is determined by the health of its Item logins, Transactions updates, Investments updates, Liabilities updates, Auth requests, Balance requests, Identity requests, Investments requests, and Liabilities requests. A login attempt is conducted during the initial Item add in Link. If there is not enough traffic to accurately calculate an institution's status, Plaid will return null rather than potentially inaccurate data.
Institution status is accessible in the Dashboard and via the API using the /institutions/get_by_id endpoint with the include_status option set to true. Note that institution status is not available in the Sandbox environment.
item_logins
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
transactions_updates
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
auth
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
identity
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
investments_updates
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
liabilities_updates
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
liabilities
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
investments
nullableobject
A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object.
status
deprecatedstring
This field is deprecated in favor of the breakdown object, which provides more granular institution health data.
HEALTHY: the majority of requests are successful DEGRADED: only some requests are successful DOWN: all requests are failing


Possible values: HEALTHY, DEGRADED, DOWN
last_status_change
string
ISO 8601 formatted timestamp of the last status change for the institution.

Format: date-time
breakdown
object
A detailed breakdown of the institution's performance for a request type. The values for success, error_plaid, and error_institution sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see Institution status details.
success
number
The percentage of login attempts that are successful, expressed as a decimal.

Format: double
error_plaid
number
The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal.

Format: double
error_institution
number
The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal.

Format: double
refresh_interval
string
The refresh_interval may be DELAYED or STOPPED even when the success rate is high. This value is only returned for Transactions status breakdowns.

Possible values: NORMAL, DELAYED, STOPPED
health_incidents
nullable[object]
Details of recent health incidents associated with the institution.
start_date
string
The start date of the incident, in ISO 8601 format, e.g. "2020-10-30T15:26:48Z".

Format: date-time
end_date
nullablestring
The end date of the incident, in ISO 8601 format, e.g. "2020-10-30T15:26:48Z".

Format: date-time
title
string
The title of the incident
incident_updates
[object]
Updates on the health incident.
description
string
The content of the update.
status
string
The status of the incident.

Possible values: INVESTIGATING, IDENTIFIED, SCHEDULED, RESOLVED, UNKNOWN
updated_date
string
The date when the update was published, in ISO 8601 format, e.g. "2020-10-30T15:26:48Z".

Format: date-time
payment_initiation_metadata
nullableobject
Metadata that captures what specific payment configurations an institution supports when making Payment Initiation requests.
supports_international_payments
boolean
Indicates whether the institution supports payments from a different country.
supports_sepa_instant
boolean
Indicates whether the institution supports SEPA Instant payments.
maximum_payment_amount
object
A mapping of currency to maximum payment amount (denominated in the smallest unit of currency) supported by the institution.
Example: {"GBP": "10000"}
supports_refund_details
boolean
Indicates whether the institution supports returning refund details when initiating a payment.
standing_order_metadata
nullableobject
Metadata specifically related to valid Payment Initiation standing order configurations for the institution.
supports_standing_order_end_date
boolean
Indicates whether the institution supports closed-ended standing orders by providing an end date.
supports_standing_order_negative_execution_days
boolean
This is only applicable to MONTHLY standing orders. Indicates whether the institution supports negative integers (-1 to -5) for setting up a MONTHLY standing order relative to the end of the month.
valid_standing_order_intervals
[string]
A list of the valid standing order intervals supported by the institution.

Possible values: WEEKLY, MONTHLY
Min length: 1
auth_metadata
nullableobject
Metadata that captures information about the Auth features of an institution.
supported_methods
nullableobject
Metadata specifically related to which auth methods an institution supports.
instant_auth
boolean
Indicates if instant auth is supported.
instant_match
boolean
Indicates if instant match is supported.
automated_micro_deposits
boolean
Indicates if automated microdeposits are supported.
request_id
string
A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.
Copy
1{
2 "institutions": [
3 {
4 "country_codes": [
5 "US"
6 ],
7 "institution_id": "ins_118923",
8 "name": "Red Platypus Bank - Red Platypus Bank",
9 "products": [
10 "assets",
11 "auth",
12 "balance",
13 "transactions",
14 "identity"
15 ],
16 "routing_numbers": [
17 "011000138",
18 "011200365",
19 "011400495"
20 ],
21 "oauth": false,
22 "status": {
23 "item_logins": {
24 "status": "HEALTHY",
25 "last_status_change": "2019-02-15T15:53:00Z",
26 "breakdown": {
27 "success": 0.9,
28 "error_plaid": 0.01,
29 "error_institution": 0.09
30 }
31 },
32 "transactions_updates": {
33 "status": "HEALTHY",
34 "last_status_change": "2019-02-12T08:22:00Z",
35 "breakdown": {
36 "success": 0.95,
37 "error_plaid": 0.02,
38 "error_institution": 0.03,
39 "refresh_interval": "NORMAL"
40 }
41 },
42 "auth": {
43 "status": "HEALTHY",
44 "last_status_change": "2019-02-15T15:53:00Z",
45 "breakdown": {
46 "success": 0.91,
47 "error_plaid": 0.01,
48 "error_institution": 0.08
49 }
50 },
51 "identity": {
52 "status": "DEGRADED",
53 "last_status_change": "2019-02-15T15:50:00Z",
54 "breakdown": {
55 "success": 0.42,
56 "error_plaid": 0.08,
57 "error_institution": 0.5
58 }
59 },
60 "investments": {
61 "status": "HEALTHY",
62 "last_status_change": "2019-02-15T15:53:00Z",
63 "breakdown": {
64 "success": 0.89,
65 "error_plaid": 0.02,
66 "error_institution": 0.09
67 },
68 "liabilities": {
69 "status": "HEALTHY",
70 "last_status_change": "2019-02-15T15:53:00Z",
71 "breakdown": {
72 "success": 0.89,
73 "error_plaid": 0.02,
74 "error_institution": 0.09
75 }
76 }
77 },
78 "investments_updates": {
79 "status": "HEALTHY",
80 "last_status_change": "2019-02-12T08:22:00Z",
81 "breakdown": {
82 "success": 0.95,
83 "error_plaid": 0.02,
84 "error_institution": 0.03,
85 "refresh_interval": "NORMAL"
86 }
87 },
88 "liabilities_updates": {
89 "status": "HEALTHY",
90 "last_status_change": "2019-02-12T08:22:00Z",
91 "breakdown": {
92 "success": 0.95,
93 "error_plaid": 0.02,
94 "error_institution": 0.03,
95 "refresh_interval": "NORMAL"
96 }
97 }
98 }
99 }
100 ],
101 "request_id": "Ggmk0enW4smO2Tp"
102}
Was this helpful?
Developer community
GitHub
GitHub
Stack Overflow
Stack Overflow
YouTube
YouTube
Twitter
Twitter
Discord
Discord