---
title: "Get institution"
method: GET
path: "/institutions/{institutionId}"
tags: ["Institutions"]
---

# Get institution

`GET /institutions/{institutionId}`

This endpoint allows you to get an institution by id, as well as the service provider metadata such as name, URL, and logos for each service provider configured to your account that support this institution

## Path parameters

- `institutionId` string, required

## Response `200`

Institution is returned

- Institution
  - `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

## Other responses

- `400` — Bad Request : check request values and format
- `401` — Invalid credentials
- `403` — Unauthenticated or authenticated with insufficient access
- `404` — Institution cannot be found
- `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)