Skip to main content
Pull the full record for one channel. The response shape matches what channel list returns. Use this when you already have an ID and want a jq-friendly read.

​
Synopsis

talkvalue path channel get <id>

​
Arguments

ArgumentTypeDescription
<id>integerChannel ID. Use channel list to find one.

​
Examples

​
1. Inspect a channel in the terminal

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

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

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 for the full mapping.

​
Response

{
  "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