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

> Fetch a single channel by ID: name, icon, color, people count, and tags.

Pull the full record for one channel. The response shape matches what [`channel list`](/cli/commands/path/channel/list) returns. Use this when you already have an ID and want a `jq`-friendly read.

## Synopsis

```bash theme={null}
talkvalue path channel get <id>
```

## Arguments

| Argument | Type    | Description                                                                    |
| -------- | ------- | ------------------------------------------------------------------------------ |
| `<id>`   | integer | Channel ID. Use [`channel list`](/cli/commands/path/channel/list) to find one. |

## Examples

### 1. Inspect a channel in the terminal

```bash theme={null}
talkvalue path channel get 7
```

Prints a single-row table with the headline fields. Use `--json` if you need the nested `tags` array or the exact ISO `createdAt` timestamp.

### 2. Read one field with jq

```bash theme={null}
talkvalue path channel get 7 --json | jq -r '.data.peopleCount'
```

Returns the people count as a raw number. Combine with other commands when you only need an attribution number, for example, computing a channel's share of total reach.

### 3. Use inside a guard

```bash theme={null}
if talkvalue path channel get 7 --json >/dev/null 2>&1; then
  echo "Channel 7 exists"
else
  echo "Channel 7 not found"
fi
```

The CLI exits non-zero when the channel ID is missing, so the guard above branches cleanly. See [Exit codes](/cli/exit-codes) for the full mapping.

## 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 on channels created without them. `tags` is always an array, empty when no tags are attached.

## See also

* [`channel list`](/cli/commands/path/channel/list). Find the ID first.
* [`channel people`](/cli/commands/path/channel/people). Page through the people on this channel.
* [`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.