---
title: "List connectors"
method: GET
path: "/usm/v1/connect-clusters/{connect_cluster_id}/connectors"
tags: ["Connectors (usm/v1)"]
---

# List connectors

`GET /usm/v1/connect-clusters/{connect_cluster_id}/connectors`

## Request

- Base URL: `https://api.confluent.cloud`
- URL: `https://api.confluent.cloud/usm/v1/connect-clusters/{connect_cluster_id}/connectors`
- Auth: one of:
  - HTTP basic
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.confluent.cloud/sts/v1/oauth2/token`

Default returns a native-compatible array of names. `?expand` returns a map keyed by name. `?page_size` switches to the paginated List envelope (Cloud-only), returning pagination metadata in headers rather than the response body so the native-compatible array/map shape is preserved (this differs from the inline-metadata pagination used by `GET /usm/v1/connect-clusters`; deliberate, see the Design Notes in the companion Confluence contract). `?show_deleted=true` includes soft-deleted (`DELETING`) connectors.

## Query parameters

- `expand` string[]
- `page_size` integer
- `page_token` string
- `show_deleted` boolean

## Response `200`

OK. Bare array of names, or the name-keyed map when `?expand` is set. The next-page cursor (when `?page_size` is set) is in the `Link` (rel="next") and `X-Next-Page-Token` response headers, never in the body.

- union
  - string[]
  - UsmConnectV1ConnectorExpansionMap

## Other responses

- `400`: Bad request (malformed body, invalid page size/token)
- `401`: Unauthenticated
- `404`: Connector or cluster not found
- `429`: Rate limited
- `500`: Internal server error

## Changes

- **2026-10-27** `018ddeaf203e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/confluent/apis/confluent-cloud-apis/changes/usm/v1/connect-clusters/:connect_cluster_id/connectors/get.md)

---

[API](https://skmtc.dev/confluent/apis/confluent-cloud-apis.md) - [All operations](https://skmtc.dev/confluent/apis/confluent-cloud-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/confluent/apis/confluent-cloud-apis/revisions/018ddeaf203e?raw)