Available in Classic and VPC
Get the list of events that occurred on a general live channel.
Request
This section describes the request format. The method and URI are as follows:
Method | URI |
---|---|
GET | /api/v2/channels/{channelId}/events |
Request headers
For information about the headers common to all Live Station APIs, see Live Station request headers.
Request path parameters
You can use the following path parameters with your request:
Field | Type | Required | Description |
---|---|---|---|
channelId |
String | Required | Channel ID
|
Request example
The request example is as follows:
curl --location --request GET 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250818******-KRXat/events' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-region_code: KR' \
--header 'Content-Type: application/json'
Response
This section describes the response format.
Response body
The response body includes the following data:
Field | Type | Required | Description |
---|---|---|---|
content |
Array | - | Event list: content |
total |
Integer | - | Total response count |
content
The following describes content
.
Field | Type | Required | Description |
---|---|---|---|
logLevel |
String | - | Log level
|
eventCode |
String | - | Event code |
description |
String | - | Event description |
timestamp |
Integer | - | Event occurrence date and time (millisecond)
|
channelId |
String | - | Channel ID |
Response status codes
For information about the HTTP status codes common to all Live Station APIs, see Live Station response status codes.
Response example
The response example is as follows:
{
"content": [
{
"logLevel": "INFO",
"eventCode": "PUBLISH_END",
"description": "channel000 channel publishing has ended.",
"timestamp": 1755591429630,
"channelId": "ls-20250818******-KRXat"
},
{
"logLevel": "INFO",
"eventCode": "ONAIR_END",
"description": "channel000 Channel recording has ended.",
"timestamp": 1755591396176,
"channelId": "ls-20250818******-KRXat"
},
{
"logLevel": "INFO",
"eventCode": "ONAIR_START",
"description": "You have started recording channel channel000.",
"timestamp": 1755591356004,
"channelId": "ls-20250818******-KRXat"
},
{
"logLevel": "INFO",
"eventCode": "PUBLISH_START",
"description": "You have started publishing channel channel000.",
"timestamp": 1755591346586,
"channelId": "ls-20250818******-KRXat"
},
...
],
"total": 25
}