---
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

---

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