---
title: "List institutions"
method: GET
path: "/institutions"
tags: ["Reference Data"]
---

# List institutions

`GET /institutions`

## Request

- Base URL: `https://api.snaptrade.com`
- URL: `https://api.snaptrade.com/institutions`
- Auth: none required

Returns the public catalog of institutions SnapTrade supports and what each one supports. The response is the same for every caller and needs no authentication. To list the brokerages a specific Client ID can connect to right now, use `GET /brokerages` instead.

A `null` field means the information is not documented yet, never that the institution lacks it. New fields and new enum values may be added over time, so ignore any you don't recognize.

## Response `200`

Enabled institutions that are generally available, in beta or in alpha, sorted by display name, including paper-trading and simulated-trading variants (`is_paper`).

- Institution[]
  - `slug` string, required: A short, unique identifier for the institution. It is usually the name in capital letters and will never change. It matches the `slug` of the same brokerage in `GET /brokerages`.
  - `name` string, required: Full name of the institution.
  - `display_name` string, required: A display-friendly name of the institution.
  - `description` string, nullable, required: A brief description of the institution.
  - `website` string, url, nullable, required: URL of the institution's website.
  - `logo_url` string, url, required: URL of the institution's rectangular logo.
  - `square_logo_url` string, url, nullable, required: URL of the institution's square logo.
  - `release_stage` 'GENERALLY_AVAILABLE' | 'BETA' | 'ALPHA', required: How mature the integration is. - `GENERALLY_AVAILABLE`: fully supported and validated for production use. - `BETA`: production-ready, with ongoing validation and improvements. - `ALPHA`: early access with limited validation. Expect issues and incomplete functionality.
  - `is_paper` boolean, required: Whether this is a paper-trading, practice or simulated-trading variant of a brokerage rather than real accounts. Filter these out to list real brokerages only.
  - `regions` string[], nullable, required: Regions where end users can connect to this institution. - `US`: United States - `CA`: Canada - `EUROPE`: Europe, including the United Kingdom - `AU`: Australia - `IN`: India
  - `connection` InstitutionConnection, required: How end users connect to the institution and what the connection allows.
    - `methods` string[], required: Ways an end user can connect. - `OAUTH`: the user signs in on the institution's own site and approves access. - `CREDENTIALS`: the user enters their login details in the SnapTrade Connection Portal. - `API_KEY`: the user creates an API key at the institution and pastes it in.
    - `scopes` string[], required: What a connection can do. `READ` is always present. - `READ`: read accounts, balances, positions and activity. - `TRADE`: place orders.

## Other responses

- `default`: Unexpected error.

## Changes

- **2026-10-09** `0e8edf44a69b`: 1 info
  - added the required property `items/is_paper` to the response with the `200` status
- **2026-10-07** `24a278733b30`: 1 warning
  - added the new `ALPHA` enum value to the `items/release_stage` response property for the response status `200`
- **2026-09-28** `d3b30b03a585`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/passiv/apis/snaptrade/changes/institutions/get.md)

---

[API](https://skmtc.dev/passiv/apis/snaptrade.md) - [All operations](https://skmtc.dev/passiv/apis/snaptrade/llms.txt) - [OpenAPI document](https://skmtc.dev/passiv/apis/snaptrade/revisions/60be624d75b7?raw)