---
title: "List whitelisted YouTube channels"
method: GET
path: "/api/v1/content_id/channels"
tags: ["Content ID"]
---

# List whitelisted YouTube channels

`GET /api/v1/content_id/channels`

Returns the channels currently whitelisted for YouTube Content ID clearance
on your account, with the whitelist license state in `meta.license`
(`null` until the first channel is added). An `expiration_date` of `null`
means the license does not expire. Status values are `active`, `inactive`,
`expired` and `quota_reached`.

## Query parameters

- `page` integer
- `per_page` integer

## Headers

- `Authorization` string, required

## Response `200`

Whitelisted channels

- object
  - `data` WhitelistedChannel[]
    - `id` string — Canonical YouTube channel ID.
    - `type` string
    - `attributes` object
      - `channel_id` string
      - `title` string
      - `avatar_url` string
  - `meta` object
    - `license` ContentIdLicenseMeta
      - `code` string — Whitelist license code.
      - `status` 'active' | 'inactive' | 'expired' | 'quota_reached' — License status. quota_reached means the single-use code has been consumed.
      - `expiration_date` string, date, nullable — Inclusive: the last day whose uploads are covered. null means the license does not expire.
    - `obj_count` integer — Total count of whitelisted channels
    - `page_count` integer — Total count of pages

## Other responses

- `403` — Missing or invalid API token

---

[API](https://skmtc.net/melod/apis/melodie-api.md) · [All operations](https://skmtc.net/melod/apis/melodie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melod/melodie-api/revisions/06cd6e66c531/schema)