---
title: "Search institutions available to the selected Workspace mode."
method: GET
path: "/api/v2/workspace/institutions"
---

# Search institutions available to the selected Workspace mode.

`GET /api/v2/workspace/institutions`

## Request

- Base URL: `https://fintable.io`
- URL: `https://fintable.io/api/v2/workspace/institutions`
- Auth: HTTP bearer

Authenticated discovery. Sandbox Workspaces return test connectors; live Workspaces return production connectors. This response is private and never shared-cached.

## Query parameters

- `key` string
- `slug` string
- `q` string
- `domain` string
- `country` string
- `provider` 'PLAID' | 'NORDIGEN' | 'AKOYA' | 'TABS' | 'SNAPTRADE' | 'ENABLEBANKING'
- `supported` 0 | 1
- `page` integer
- `workspace_id` string

## Response `200`

Domain groups and their connection options.

- object
  - `data` InstitutionGroup[], required
    - `key` string, required: Normalized domain grouping key, or an institution-specific key when no domain is known. Use connection slugs for persistent links; this key changes if the domain changes.
    - `name` string, required
    - `alternative_names` string[], required: Known aliases from the group's connections and adopted metadata, excluding duplicates, the displayed name and aliases contained in a longer alias.
    - `domain` string, nullable, required
    - `domain_verified` boolean, required
    - `countries` string[], required
    - `default_connection` string, required: Slug of the best matching connection for these search filters and country preference.
    - `connections` InstitutionConnection[], required
      - `slug` string, required
      - `name` string, required
      - `provider` object, required
        - `id` string, required
        - `name` string, required
        - `display_name` string, required
      - `countries` string[], required
      - `supported` boolean, required
      - `connect_url` string, nullable, required
      - `coverage_url` string, nullable, required
      - `requires_mobile_app` boolean, required
      - `is_test_connection` boolean, required
      - `is_defunct` boolean, required: The institution no longer operates under its own name (merged, absorbed, rebranded or wound up); the connector describes that old entity.
      - `updated_at` string, date-time, nullable, required
  - `meta` object, required
    - `page` integer, required
    - `per_page` 10, required
    - `has_more` boolean, required

---

[API](https://skmtc.dev/fintable/apis/fintable-api.md) · [All operations](https://skmtc.dev/fintable/apis/fintable-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fintable/apis/fintable-api/revisions/b5ed1cf8f417?raw)