Penny Docs
Institutions

List Institutions

GET
/v1/institutions

Searches the financial institution directory by name. Authentication is not required.

Results use offset pagination: limit defaults to 20 and accepts 1–100; advance offset by the number of results received while has_more is true. Apple appears first when it matches the search, followed by stored institutions ordered by name. Each result includes provider metadata and a resolved image URL.

Query Parameters

search?string|null
limit?Limit
Range1 <= value <= 100
Default20
offset?Offset
Range0 <= value
Default0

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/institutions"
{  "institutions": [    {      "id": "ins_109508",      "provider": "plaid",      "name": "Chase",      "url": "https://www.chase.com/",      "image_url": "https://cdn.penny.finance/institutions/chase.png",      "primary_color": "#117ACA",      "popularity_rank": 1    }  ],  "total": 12847,  "limit": 25,  "offset": 25,  "has_more": true}