---
title: "チャンネルリストの照会"
slug: "b2bpls-channellist"
updated: 2026-09-17T09:58:08Z
published: 2026-09-17T09:58:08Z
canonical: "api.ncloud-docs.com/b2bpls-channellist"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# チャンネルリストの照会

Classic/VPC環境で利用できます。

ユーザーのチャンネルリストを照会する APIです。B2B PRISM Live Studioでの使用フローを確認するには、[配信開始プロセス](https://guide.ncloud-docs.com/docs/ja/b2bpls-livestart)をご参照ください。

## リクエスト

リクエスト形式は次の通りです。

```
GET {serviceApiDomain}/prism/v1/service/channel/list
```

### リクエストヘッダ

ヘッダの説明は次の通りです。

| 名前 | タイプ | 説明 | 必須有無 |
| --- | --- | --- | --- |
| x-prism-access-token | String | OAuth2.0認証により発行した Access Token | Y |

## レスポンス

レスポンス形式を説明します。

              参考

              

デフォルトのレスポンス形式は [APIレスポンスのデフォルト形式](/docs/ja/b2bpls-overview#%EA%B8%B0%EB%B3%B8%EC%9D%91%EB%8B%B5%ED%98%95%EC%8B%9D)をご参照ください。

| 名前 | タイプ | 説明 | 必須有無 |
| --- | --- | --- | --- |
| userName | String | B2B PRISM Live Studioで表示されるユーザー名 | Y |
| channels | Object | channelリスト | Y |

### channel DTO

channel DTOの説明は、次の通りです。

## 例

構文例を紹介します。

### リクエスト例

構文例は次の通りです。

```
curl -X GET {serviceApiDomain}/prism/v1/service/channel/list
    -H "x-prism-access-token: {access-token}"
```

### レスポンス例

構文例は次の通りです。

```
{
    "success": true,
    "errorCode": 0,
    "errorName": null,
    "message": null,
    "data": {
        "channels": [
            {
                "channelId": 2a7b15c5,
                "channelName": "チャンネル ro4",
                "channelEnabled": true,
                "channelLink": "https://prismlive.com",
                "channelDescription": "チャンネル ro4のチャンネルです。",
                "channelTags": "モクバン",
                "channelThumbnailUrl": null,
                "channelFollowerCount": 12345
            },
            {
                "channelId": 2e284f3g,
                "channelName": "チャンネル62k",
                "channelEnabled": false,
                "channelLink": "https://prismlive.com",
                "channelDescription": "チャンネル62kのチャンネルです。",
                "channelTags": null,
                "channelThumbnailUrl": null,
                "channelFollowerCount": 12345
            },
            {
                "channelId": 18243eab,
                "channelName": "チャンネル iq4",
                "channelEnabled": true,
                "channelLink": "https://prismlive.com",
                "channelDescription": "ポストマンで作成した新規チャンネルです。",
                "channelTags": "モクバン",
                "channelThumbnailUrl": null,
                "channelFollowerCount": 0
            }
        ],
        "userName": "管理者"
    }
}
```