---
title: "List connections"
method: GET
path: "/v1/projects/{project_id}/connections"
tags: ["connections"]
---

# List connections

`GET /v1/projects/{project_id}/connections`

## Request

- Base URL: `https://api.connic.co`
- URL: `https://api.connic.co/v1/projects/{project_id}/connections`
- Auth: HTTP bearer

List connections for the project, optionally filtered by connector type.

Required permission: `connections.view`.

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `type` string, nullable: Only connections usable by this connector type, such as `kafka`.

## Response `200`

Successful Response

- ConnectionListResponse
  - `connections` ConnectionResponse[], required: Connections in the project, oldest first.
    - `id` string, uuid, required
    - `project_id` string, uuid, required: Project the connection belongs to.
    - `name` string, required
    - `type` string, required: Connection type. Related connector types that share credentials use the same type.
    - `config` object, required: Credential fields, with secret fields masked as `********`.
    - `created_at` string, required
    - `updated_at` string, required
    - `connector_ids` string[]: IDs of the connectors that use this connection, in any environment.
    - `connectors` ConnectionConnectorResponse[]: Connectors that use this connection, in any environment. A connection in use can't be deleted.
      - `id` string, uuid, required
      - `name` string, required
      - `environment_id` string, uuid, required: Environment the connector runs in.
      - `managed_key` string, nullable: Key of the `connectors/<key>.yaml` file that defines the connector in code, or null.

## Other responses

- `401`: Missing or invalid API key.
- `403`: The API key lacks the required permission or access to the environment.
- `422`: Validation Error
- `429`: Rate limit exceeded.

---

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