---
title: "Retrieve a list of institutions"
method: GET
path: "/institutions"
tags: ["Institutions (Beta)"]
---

# Retrieve a list of institutions

`GET /institutions`

## Query parameters

- `country_codes` string[], required
- `routing_numbers` string[], required
- `page_token` string — Optional pagination token to be provided to retrieve subsequent pages, returned from previous get

## Response `200`

list of institutions

- InstitutionList — An array of institutions
  - `institutions` Institution[]
    - `country_codes` string[], required — The countries of operation of the financial institution
    - `logo` string — Base64 encoded representation of the institution's logo, returned as a base64 encoded 152x152 PNG
    - `name` string, required — The name of the financial institution
    - `routing_identifiers` RoutingIdentifier[], required — Array of routing identifier objects
      - `location` string — The address of the institution with the routing number specified in the routing_idetifier object
      - `payment_rails` string[] — The supported payment types by the routing number specified in routing_identifier
      - `routing_number` string, required — A sequence of digits used to identify specific financial institution
  - `next_page_token` string — If returned, use the next_page_token to query for the next page of results. Not returned if there are no more rows.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden error
- `500` — Internal server error

---

[API](https://skmtc.net/synctera/apis/synctera-api.md) · [All operations](https://skmtc.net/synctera/apis/synctera-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synctera/synctera-api/revisions/b0d812e6cdd0/schema)