> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chowder.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Channel Status

> Check whether a channel is enabled and connected.

Returns the current status of a specific channel on an instance — whether it's enabled in the config and whether it's actually connected and running.

## Authentication

Requires an **org-level API key** or a **scoped token** with the `channels` permission.

## Path Parameters

<ParamField path="instance_id" type="string" required>
  The ID of the instance.
</ParamField>

<ParamField path="channel" type="string" required>
  The channel identifier (e.g. `discord`, `whatsapp`).
</ParamField>

## Response

<ResponseField name="channel" type="string">
  The channel identifier.
</ResponseField>

<ResponseField name="enabled" type="boolean">
  Whether the channel is enabled in the instance configuration.
</ResponseField>

<ResponseField name="connected" type="boolean">
  Whether the channel is actively connected and running.
</ResponseField>

<ResponseField name="details" type="object">
  Additional status details, if available. The shape of this object varies by channel.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  curl -X GET https://api.chowder.dev/v1/instances/ins_abc123/channels/discord/status \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  {
    "channel": "discord",
    "enabled": true,
    "connected": true,
    "details": {
      "guilds": 3,
      "uptime_seconds": 84200
    }
  }
  ```
</ResponseExample>