---
title: "使えるチャンネルの一覧"
method: GET
path: "/api/v1/channels"
tags: ["channels"]
---

# 使えるチャンネルの一覧

`GET /api/v1/channels`

## Request

- Base URL: `https://app.yukkurigen.com`
- URL: `https://app.yukkurigen.com/api/v1/channels`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Response `200`

一覧

- object
  - `channels` object[], required
    - `id` string, required: channelId にそのまま渡せる
    - `name` string, required
    - `theme` string
    - `targetAudience` string
    - `templateId` string, nullable
  - `note` string

## Other responses

- `401`: 未認証
- `403`: 権限不足（projects:read / code: insufficient_scope）
- `500`: 取得失敗

## Changes

- **2026-10-20** `ba5f36b016da`: 15 warning, 9 info
  - added the new `already_subscribed` enum value to the `code` response property for the response status `401`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `403`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `500`
  - added the new `render_not_paid` enum value to the `code` response property for the response status `401`
  - …20 more

[Operation history](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/changes/api/v1/channels/get.md)

---

[API](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api.md) · [All operations](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/revisions/ba5f36b016da?raw)