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

# List Channels

> Get all available channels for an instance.

Returns the list of channels available for a given instance, along with their connection type and whether they're currently enabled.

## 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 to list channels for.
</ParamField>

## Response

Returns an array of channel objects.

<ResponseField name="channels" type="array">
  <Expandable title="Channel object">
    <ResponseField name="channel" type="string">
      The channel identifier (e.g. `discord`, `whatsapp`, `telegram`).
    </ResponseField>

    <ResponseField name="connection_type" type="string">
      Either `"token"` or `"interactive"`. Token-based channels are configured with credentials directly. Interactive channels (like WhatsApp) require a pairing flow such as QR scanning.
    </ResponseField>

    <ResponseField name="enabled" type="boolean">
      Whether this channel is currently active on the instance.
    </ResponseField>
  </Expandable>
</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 \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  [
    {
      "channel": "discord",
      "connection_type": "token",
      "enabled": true
    },
    {
      "channel": "whatsapp",
      "connection_type": "interactive",
      "enabled": false
    },
    {
      "channel": "telegram",
      "connection_type": "token",
      "enabled": false
    }
  ]
  ```
</ResponseExample>