---
title: "List Connections"
method: GET
path: "/v2/connection"
---

# List Connections

`GET /v2/connection`

List all connections with optional filtering. Does not retrieve secrets or perform any connection healthcheck. For that use `getConnection` or `checkConnectionHealth`.

## Query parameters

- `limit` integer — Limit the number of items returned
- `offset` integer — Offset the items returned
- `connection_ids` string[]
- `connector_names` CoreConnectorName[]
- `customer_id` string — The id of the customer in your application. Ensure it is unique for that customer.
- `connector_config_id` string — The id of the connector config, starts with `ccfg_`
- `include_secrets` boolean
- `expand` string[] — Expand the response with additional optionals
- `search_query` string
- `refresh_policy` 'none' | 'force' | 'auto' — Controls credential refresh: none (never), force (always), or auto (when expired, default)
- `repl_id` string

## Response `200`

Successful response

- object — The list of connections
  - `items` unknown[], required
    - unknown
  - `total` integer, required — Total number of items in the database for the organization
  - `limit` integer, required — Limit the number of items returned
  - `offset` integer, required — Offset the items returned
  - `has_next_page` boolean — Convenience flag = offset + limit >= total

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `404` — Not found
- `500` — Internal server error

## Changes

- **2025-09-22** `1b84cd7f5c05` — 140 breaking, 13 info
  - for the `query` request parameter `refresh_policy`, default value was changed from `none` to `auto`
  - removed the enum value `accelo` from the property `items/` of the `query` request parameter `connector_names`
  - removed the enum value `adobe` from the property `items/` of the `query` request parameter `connector_names`
  - removed the enum value `adyen` from the property `items/` of the `query` request parameter `connector_names`
  - …149 more
- **2025-08-27** `d1701d4f03bd` — 3 info
  - added the enum value `slack-agent` to the property `items/` of the `query` request parameter `connector_names`
  - added `subschema #2, subschema #3` to the `items/items/` response property `allOf` list for the response status `200`
  - removed `subschema #2, subschema #3` from the `items/items/` response property `allOf` list for the response status `200`
- **2025-08-26** `e56d53697f09` — 1 info
  - added the new optional `query` request parameter `repl_id`
- **2025-08-26** `8939526af685` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openintegrations/apis/openint-api/changes/v2/connection/get.md)

---

[API](https://skmtc.dev/openintegrations/apis/openint-api.md) · [All operations](https://skmtc.dev/openintegrations/apis/openint-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintegrations/openint-api/revisions/1b84cd7f5c05/schema)