---
title: "List connected integrations"
method: GET
path: "/v1/integrations"
tags: ["Integrations"]
---

# List connected integrations

`GET /v1/integrations`

## Request

- Base URL: `https://api.banksync.io`
- URL: `https://api.banksync.io/v1/integrations`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

List integrations connected to the current workspace. Pass `?scope=family` to include integrations from every portal under this workspace. Family scope requires admin+ role and is only valid on a top-level workspace. Provider auth tokens are stripped from all responses.

## Query parameters

- `scope` 'self' | 'family': Resource scope. `self` (default) returns this workspace only. `family` includes every portal under it; each row gains `workspaceId` + `portal: { id, name, icon } | null`. Admin+ only, top-level workspaces only.

## Response `200`

List of integrations (auth tokens excluded). With `scope=family`, each row additionally carries `workspaceId` and `portal`.

- object
  - `success` true, required
  - `data` object[], required
    - `id` string, required
    - `name` string, required
    - `type` 'notion' | 'google_sheets' | 'airtable' | 'excel' | 'database' | 'webhook' | 'ynab', required
    - `iconUrl` string, required
    - `databaseIntegration` object
    - `webhookIntegration` object
    - `ynabIntegration` object
    - `icon` string
    - `order` number, required
    - `createdAt` string, required
    - `updatedAt` string, required

## Other responses

- `400`: Invalid `scope` value, or `scope=family` was requested against a portal workspace
- `401`: Unauthorized
- `403`: Forbidden — `scope=family` requires admin+ role

---

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