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

> ## 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/{channelId}/lives
```

### リクエストヘッダ

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

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

### リクエストパスパラメータ

パラメータについての説明は、次の通りです。

| 名前 | タイプ | 説明 | 必須有無 |
| --- | --- | --- | --- |
| channelId | String | 照会対象チャンネル ID | Y |

### リクエストクエリパラメータ

パラメータについての説明は、次の通りです。

| 名前 | タイプ | 説明 | 必須有無 |
| --- | --- | --- | --- |
| status | String | 照会対象ライブの状態ALL、RESERVED、ON_AIR、ENDデフォルト値: ALL | Y |

## レスポンス

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

              参考

              

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

| 名前 | タイプ | 説明 | 必須有無 |
| --- | --- | --- | --- |
| channelId | String | チャンネル ID | Y |
| lives | Object | ライブリスト | Y |

### live dto

live dtoの説明は、次の通りです。

### liveStat dto

liveStat dtoの説明は、次の通りです。

## 例

構文例を紹介します。

### リクエスト例

構文例は次の通りです。

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

### レスポンス例

構文例は次の通りです。

```
{
    "success": true,
    "errorCode": 0,
    "errorName": null,
    "message": null,
    "data": {
        "lives": [
            {
                "liveId": 14293,
                "title": "ライブ中です。",
                "description": "ライブの説明です。",
                "reservedAt": "2023-10-26T17:11:44+09:00",
                "startAt": "2023-10-26T17:11:44+09:00",
                "rtmpPath": "rtmp://global.rtmp.lip2.navercorp.com:8080/relay/8cnft2bpuhdm1vlx58vfa5nx78rs",
                "status": "ON_AIR",
                "liveLink": "https://test.com/14293",
                "scope": "LIMITED",
                "liveStat": {
                    "viewCount": 163,
                    "viewerCount": 3,
                    "likeCount": 46,
                    "chatCount": 2
                }
            },
            {
                "liveId": 14286,
                "title": "ライブです。",
                "description": "終了したライブです。",
                "reservedAt": "2023-10-26T17:09:15+09:00",
                "startAt": "2023-10-26T17:09:57+09:00",
                "rtmpPath": "rtmp://global.rtmp.lip2.navercorp.com:8080/relay/5izsqqbzr71sed7qn8vf8g2hx5at",
                "status": "END",
                "liveLink": "https://test.com/14293",
                "scope": "PUBLIC",
                "liveStat": {
                    "viewCount": 925,
                    "viewerCount": 60,
                    "likeCount": 166,
                    "chatCount": 2
                }
            }
        ],
        "channelId": 1000
    }
}
```