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

# talkvalue path channel list

> List every channel in the active workspace: name, icon, color, people count, and tags.

Print every channel in the active workspace as a table or JSON. Useful as the first call when you want to find a channel ID before drilling into the people behind it, or as the data source for a recurring channel-mix report.

## Synopsis

```bash theme={null}
talkvalue path channel list
```

## Options

This command takes no flags beyond the [global flags](/cli/global-flags). Filtering and pagination happen client-side. Pipe through `jq` or `--json` to slice the result.

## Examples

### 1. Browse channels in the terminal

```bash theme={null}
talkvalue path channel list
```

Prints every channel as a table: ID, name, icon, color, people count, tags, created-at. Channels appear in the order the server returns them.

### 2. Find a channel ID with jq

```bash theme={null}
talkvalue path channel list --json \
  | jq '.data[] | select(.name | test("Newsletter"; "i")) | {id, name, peopleCount}'
```

Returns the ID, name, and people count of every channel whose name contains `Newsletter` (case-insensitive). Use the ID with [`channel get`](/cli/commands/path/channel/get) or [`channel people`](/cli/commands/path/channel/people).

### 3. Snapshot a channel-mix report

```bash theme={null}
ts=$(date +%Y-%m-%d)
talkvalue path channel list --json \
  | jq -r '.data[] | [.id, .name, .peopleCount] | @csv' \
  > "snapshots/channels-$ts.csv"
```

Loops over every channel and writes a three-column CSV. Drop into a cron job for a periodic mix snapshot outside of TalkValue.

## Response

```jsonc theme={null}
{
  "data": [
    {
      "id": 7,
      "name": "Newsletter",
      "icon": "mail",
      "color": "#5252FF",
      "peopleCount": 1843,
      "tags": [{ "id": 4, "name": "Owned channel" }],
      "createdAt": "2026-01-08T00:00:00Z"
    }
  ]
}
```

`icon` and `color` are nullable when the channel was created without them. `peopleCount` is the count of distinct people attributed to the channel, the same number the dashboard shows on the Channels list.

## See also

* [`channel get`](/cli/commands/path/channel/get). Fetch one channel by ID.
* [`channel people`](/cli/commands/path/channel/people). Drill into the people behind `peopleCount`.
* [`path analysis channel-attribution`](/cli/commands/path/analysis/channel-attribution). Channel reach and contribution metrics.
* [Channels](/path/manage/channels). The dashboard surface this command mirrors.