---
title: "GET /v2/channel/list"
method: GET
path: "/v2/channel/list"
tags: ["v2"]
---

# GET /v2/channel/list

`GET /v2/channel/list`

## Request

- Base URL: `https://api.inside.ad/api`
- URL: `https://api.inside.ad/api/v2/channel/list`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://api.inside.ad/api/oauth/authorize`, token URL `https://api.inside.ad/api/oauth/token`, scopes: `channels:read`)
  - API key in header `authorization`

Get the full list of the authenticated user's channels (same data/format as /channels/getChannels).

## Query parameters

- `userId` number, required

## Response `200`

Default Response

- object
  - `success` boolean
  - `channels` object[]
    - `channelId` number, required: Unique channel ID
    - `userId` number, required: Owning user (publisher)
    - `members` number: Current subscriber count
    - `title` string, required
    - `description` string
    - `type` string, required: Telegram chat type, e.g. 'channel'
    - `username` string: Telegram @username, empty for private channels
    - `inviteLink` string
    - `languageCode` string, required
    - `statusUser` string, required: Moderation/lifecycle status: e.g. 'active', 'hidden', 'banned'
    - `status` string: Bot's own membership status in the chat, e.g. 'administrator'
    - `possibleStatusString` string, required: Human-readable reason/explanation for the current statusUser
    - `category` string, required: Primary content category (topic) of the channel
    - `keywords` string, required: Comma-separated audience/content keywords used for ad targeting
    - `allowedCategories` string, required: Ad categories this channel accepts, comma-separated
    - `disallowedCategories` string, required: Ad categories this channel refuses, comma-separated
    - `adPostSlotsWeek` string: Weekly schedule of ad-post slots (encoded string)
    - `teaserSlotsWeek` string: Weekly schedule of teaser slots (encoded string)
    - `autoGenerateContent` number, nullable
    - `generateContentSettings` string
    - `enableDirectPosts` number: 1 = channel accepts direct (non-auction) posts
    - `maxPosts` number: Max ad-posts allowed per day
    - `maxTeasers` number: Max teasers allowed per day
    - `cpmStrategy` string
    - `country` string, required: ISO-2 country code of the channel audience
    - `tier` number: GEO price tier derived from country, 0 = unverified
    - `tierVerified` number
    - `countryLocked` number: 1 = country was determined from real audience data, read-only
    - `subdivisions` string, required
    - `can_edit_messages` number, required: Bot permission flag (1/0), not a content setting
    - `can_post_messages` number: Bot permission flag (1/0), not a content setting
    - `can_invite_users` number, required: Bot permission flag (1/0), not a content setting
    - `can_change_info` number: Bot permission flag (1/0), not a content setting
    - `moderated` number, required: 1 = passed moderation, 0 = pending/not yet
    - `preModerated` number
    - `moderatedDate` number: Timestamp in milliseconds
    - `moderatedReason` number: Rejection reason code; human text lives in a separate dictionary
    - `rejectComment` string, nullable: Free-text moderator comment left when rejecting the channel, max 100 chars
    - `statsViews` number, required
    - `statsMembers` number, required
    - `can_send_messages` number, required: Bot permission flag (1/0), not a content setting
    - `updatedAt` string
    - `createdAt` string
    - `brandSafe` number, nullable
    - `top` number, nullable: 1 = top channel, 0 = not top, null = not set
    - `timezone` string
    - `avgViews30D` number: Average post views over the last 30 days
    - `avatarBig` string
    - `avatarSmall` string
    - `suspicious` number: 1 = flagged by anti-fraud heuristics
    - `bid_1_24` number
    - `bid_2_48` number
    - `landingDescription` string
    - `enableNotification` number
    - `mCpmBidTeaser` number: Teaser CPM bid, in milli-USD ($1 = 1000)
    - `mCpmBidAdPost` number: Ad-post CPM bid, in milli-USD ($1 = 1000)
    - `mCpmBidTeaserCurrent` number: Effective teaser CPM bid after discounts, milli-USD
    - `mCpmBidAdPostCurrent` number: Effective ad-post CPM bid after discounts, milli-USD
    - `allowPaidAds` number
    - `lowQualityContent` number
    - `isKidsChannel` number: 1 = channel targets a children audience, ads are blocked
    - `minCPM` number: Minimum CPM the channel accepts, milli-USD
    - `allowPromoPost` number
    - `sendToModerationDate` number: Timestamp in milliseconds
    - `repack_topic` string
    - `enableCross` number
    - `comment` string, nullable

---

[API](https://skmtc.dev/inside/apis/inside-ad-api-documentation-v2-ai-optimized.md) · [All operations](https://skmtc.dev/inside/apis/inside-ad-api-documentation-v2-ai-optimized/llms.txt) · [OpenAPI document](https://skmtc.dev/inside/apis/inside-ad-api-documentation-v2-ai-optimized/revisions/79912b433f7f?raw)