---
title: "List connections"
method: GET
path: "/connectors/v1/connections"
tags: ["Connectors"]
---

# List connections

`GET /connectors/v1/connections`

## Request

- Base URL: `https://api.case.dev`
- URL: `https://api.case.dev/connectors/v1/connections`
- Auth: HTTP bearer

List provider connections for the organization, with health status. Returns at most `limit` connections (default 200, maximum 200). When `pagination.has_more` is true, replay `pagination.next_cursor` as `?cursor=` to fetch the following page. Cursors are opaque and are only valid for the exact filter set and installation/subject scope they were issued under.

## Query parameters

- `provider` string
- `status` 'pending' | 'healthy' | 'reauth_required' | 'revoked' | 'throttled'
- `limit` integer
- `cursor` string

## Headers

- `x-case-connector-subject` string

## Response `200`

Connections for the organization

- object
  - `connections` object[]
    - `organization_id` string: Authenticated organization owning this connection; server-side approval binding uses this identifier.
  - `pagination` object
    - `limit` integer
    - `has_more` boolean
    - `next_cursor` string, nullable
  - `cursor` string, nullable: Mirror of `pagination.next_cursor`. Prefer `pagination`.
  - `providers` object[]: Available import providers and their adapter-declared capabilities.
    - `id` string
    - `scope_tier` string
    - `browse_scope_tiers` string[]: Exact enabled tiers accepted by the adapter browse policy.
    - `authorization_options` object[]: Adapter-declared consent choices, filtered by deployment and organization policy.
      - `scope_tier` string
      - `label` string
      - `write_scope_tier` string, nullable: Explicit write-authorization upgrade for this account choice. Null means unavailable by policy; omitted when no upgrade is required.
    - `supports_export` boolean
    - `resource_types` string[]
    - `search` object, nullable: Present when GET /connections/{id}/search works for this provider.
      - `scopes` string[]
      - `full_text` boolean
      - `folder_scope_recursive` boolean
      - `max_page_size` integer
  - `capabilities` object
    - `google_drive_folder_mirroring` boolean

## Other responses

- `400`: Invalid cursor or limit
- `401`: Invalid API key
- `403`: Insufficient permissions

## Changes

- **2026-10-28** `f9540d1ffad1`: 1 info
  - added the optional property `providers/items/search` to the response with the `200` status
- **2026-10-22** `67fe26768ee0`: 1 info
  - added the optional property `providers/items/authorization_options/items/write_scope_tier` to the response with the `200` status
- **2026-10-22** `44858032985d`: 2 info
  - added the optional property `providers/items/authorization_options` to the response with the `200` status
  - added the optional property `providers/items/browse_scope_tiers` to the response with the `200` status
- **2026-10-16** `1ebd3fa45f31`: 1 info
  - added the optional property `connections/items/organization_id` to the response with the `200` status
- **2026-10-16** `a21d188f4b21`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/casemark/apis/case-dev-api/changes/connectors/v1/connections/get.md)

---

[API](https://skmtc.dev/casemark/apis/case-dev-api.md) - [All operations](https://skmtc.dev/casemark/apis/case-dev-api/llms.txt) - [OpenAPI document](https://skmtc.dev/casemark/apis/case-dev-api/revisions/9a3245c00044?raw)