Institutions

institutionsGet

POST
/institutions/get

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.

Authorization

PLAID-CLIENT-ID PLAID-SECRET Plaid-Version
PLAID-CLIENT-ID<token>

In: header

PLAID-SECRET<token>

In: header

Plaid-Version<token>

In: header

Request Body

application/json

InstitutionsGetRequest defines the request schema for /institutions/get

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*integer

The total number of Institutions to return.

Formatint32
Rangevalue <= 500
offset*integer

The number of Institutions to skip.

Formatint32
country_codes*array<>

Specify an array of Plaid-supported country codes this institution supports, using the ISO-3166-1 alpha-2 country code standard.

Items1 <= items
options?

An optional object to filter /institutions/get results.

Response Body

application/json

application/json

curl -X POST "https://example.com/institutions/get" \  -H "Content-Type: application/json" \  -d '{    "count": 500,    "offset": 0,    "country_codes": [      "US"    ]  }'
{  "institutions": [    {      "country_codes": [        "US"      ],      "institution_id": "ins_1",      "name": "Bank of America",      "oauth": false,      "products": [        "assets",        "auth",        "balance",        "transactions",        "identity",        "liabilities"      ],      "routing_numbers": [        "011000138",        "011200365",        "011400495",        "011500010",        "011900254",        "021000322",        "021200339",        "026009593",        "031202084",        "051000017",        "052001633",        "053000196",        "053904483",        "054001204",        "061000052",        "063100277",        "064000020",        "071214579",        "072000805",        "073000176",        "081000032",        "081904808",        "082000073",        "101100045",        "103000017",        "107000327",        "111000025",        "121000358",        "122101706",        "122400724",        "123103716",        "125000024",        "323070380"      ]    }  ],  "request_id": "tbFyCEqkU774ZGG",  "total": 11384}