---
title: "Get connector status"
method: GET
path: "/v1/kafka-connect/clusters/{cluster_name}/connectors/{name}/status"
tags: ["Kafka Connect"]
---

# Get connector status

`GET /v1/kafka-connect/clusters/{cluster_name}/connectors/{name}/status`

## Request

- Base URL: `https://{dataplane_api_url}`
- URL: `https://{dataplane_api_url}/v1/kafka-connect/clusters/{cluster_name}/connectors/{name}/status`
- Auth: OAuth 2
  - Implicit: `https://auth.prd.cloud.redpanda.com/oauth/authorize`

Gets the current status of the connector, including the state for each of its tasks, error information, etc.

## Path parameters

- `cluster_name` string, required
- `name` string, required

## Response `200`

OK

- ConnectorStatus
  - `connector` Connector
    - `state` string: State of the connector instance.
    - `trace` string: String value of stack trace.
    - `worker_id` string: ID of worker that the connector is assigned to.
  - `errors` ConnectorError[]: List of parsed connectors' and tasks' errors.
    - `content` string: Detailed description of the error.
    - `title` string: Short description of the error.
    - `type` 'TYPE_ERROR' | 'TYPE_WARNING': Error level.
  - `holistic_state` 'CONNECTOR_HOLISTIC_STATE_PAUSED' | 'CONNECTOR_HOLISTIC_STATE_RESTARTING' | 'CONNECTOR_HOLISTIC_STATE_DESTROYED' | 'CONNECTOR_HOLISTIC_STATE_STOPPED' | 'CONNECTOR_HOLISTIC_STATE_UNASSIGNED' | 'CONNECTOR_HOLISTIC_STATE_HEALTHY' | 'CONNECTOR_HOLISTIC_STATE_UNHEALTHY' | 'CONNECTOR_HOLISTIC_STATE_DEGRADED' | 'CONNECTOR_HOLISTIC_STATE_UNKNOWN': State of a connector or one of its tasks, as described in the [Kafka Connect documentation](https://kafka.apache.org/documentation.html#connect_administration). Takes into account not just the state of the connector instance itself, but also the tasks within the connector. - CONNECTOR_HOLISTIC_STATE_PAUSED: The connector or task has been administratively paused. - CONNECTOR_HOLISTIC_STATE_RESTARTING: The connector or task is restarting. - CONNECTOR_HOLISTIC_STATE_DESTROYED: The connector is destroyed, regardless of any tasks. - CONNECTOR_HOLISTIC_STATE_STOPPED: The connector or task has been stopped. - CONNECTOR_HOLISTIC_STATE_UNASSIGNED: - The connector or task has not yet been assigned to a worker, - THe connector is running, but there are unassigned tasks. - CONNECTOR_HOLISTIC_STATE_HEALTHY: The connector is running, > 0 tasks, all of them in running state. - CONNECTOR_HOLISTIC_STATE_UNHEALTHY: - The connector has failed, - The connector is running, but has no tasks, - Connector is running and has tasks, but all tasks have failed. - CONNECTOR_HOLISTIC_STATE_DEGRADED: The connector is running and has tasks, and at least one task, but not all, have failed. - CONNECTOR_HOLISTIC_STATE_UNKNOWN: The connector or task state could not be determined.
  - `name` string: Name of connector.
  - `tasks` TaskStatus[]: Status of connector tasks. For more information, see the [https://docs.redpanda.com/current/deploy/deployment-option/cloud/managed-connectors/monitor-connectors/#connector-tasks](Monitor Connectors) documentation.
    - `id` integer: The connector task ID.
    - `state` string: State of connector task.
    - `trace` string: String value of stack trace.
    - `worker_id` string: ID of worker that the task is assigned to.
  - `type` string: Type of connector (sink or source).

## Other responses

- `401`: Unauthenticated.
- `500`: Internal Server Error. Reach out to support.
- `default`: An unexpected error response.

## Changes

- **2025-03-18** `d8ef59d98e13`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/changes/v1/kafka-connect/clusters/:cluster_name/connectors/:name/status/get.md)

---

[API](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api.md) - [All operations](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/llms.txt) - [OpenAPI document](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/revisions/ff1b476fd533?raw)