---
title: "Search institutions"
method: GET
path: "/institutions"
tags: ["Institutions"]
---

# Search institutions

`GET /institutions`

Allows you to search across the list of Institutions supported by your service providers. This endpoint is only available in production.

## Query parameters

- `before` string
- `after` string
- `serviceProviders` string
- `limit` string
- `name` string
- `type` string
- `regions` string

## Response `200`

Institution snapshot is returned

- InstitutionPage
  - `count` integer — Number of institutions returned.
  - `institutions` Institution[] — Institutions
    - `aliases` string[] — List of aliases for the institution
    - `domain` string — Base url for the institution
    - `id` string — Institution's Meld Id
    - `images` Images
      - `icon` string — Url of the icon image for the institution
      - `tile` string — Url of the tile image for the institution
      - `wide` string — Url of the wide image for the institution
    - `isTest` boolean — If the institution is a test institution
    - `key` string — The key of the institution in the paginated list of results
    - `name` string — Name
    - `providers` object — Mapped service provider institutions
    - `rank` integer — Institution's popularity score, which is used to rank institutions in the bank linking connect widget
    - `subName` string — Alternate name that may be provided by the service provider
    - `type` string — Type of the institution
  - `remaining` integer — Number of remaining institutions before/after this page, depending the direction this page was selected.

## Other responses

- `400` — Bad Request : check request values and format
- `401` — Invalid credentials
- `403` — Unauthenticated or authenticated with insufficient access
- `500` — Server Error. This applies to all 5xx errors, including but not limited to 500, 501, 502, 503, and 504 errors. You should treat all of these errors the same.

---

[API](https://skmtc.net/meld/apis/bank-linking.md) · [All operations](https://skmtc.net/meld/apis/bank-linking/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meld/bank-linking/revisions/818d6079a611/schema)