Get recording file list

Available in Classic and VPC

Get the file list recorded in a live channel.

Request

This section describes the request format. The method and URI are as follows:

Method	URI
GET	/api/v2/channels/{channelId}/records

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 See Get channel list.

Request example

The request example is as follows:

curl --location --request GET 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250814******-PZohi/records' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--header 'x-ncp-region_code: KR'

Response

This section describes the response format.

Response body

The response body includes the following data:

Field	Type	Required	Description
`content`	Object	-	Response result
`content.recordList`	Object	-	Recording file list
`content.recordList.{recordId}`	Object	-	Recording file information `{recordId}`: Recording file ID
`content.recordList.{recordId}.recordType`	String	-	Recording file type `MP4` \| `HLS`
`content.recordList.{recordId}.channelId`	String	-	Channel ID
`content.recordList.{recordId}.status`	String	-	File status `RECORDING` \| `PROCESSING` \| `PROCESSING_FAIL` \| `TRANSFER_READY` \| `TRANSFER` \| `TRANSFER_FINISH` \| `TRANSFER_FAIL` \| `DELETED` `RECORDING`: Recording `PROCESSING`: Processing `PROCESSING_FAIL`: Processing failed `TRANSFER_READY`: Transfer pending `TRANSFER`: Transferring `TRANSFER_FINISH`: Transfer completed `TRANSFER_FAIL`: Transfer failed `DELETED`: Deleted
`content.recordList.{recordId}.recordSeq`	Integer	-	Recording file sequence number
`content.recordList.{recordId}.streamSeq`	Integer	-	Stream sequence number
`content.recordList.{recordId}.recordBeginTime`	Integer	-	Recording start date and time (millisecond) Unix timestamp format
`content.recordList.{recordId}.createdTime`	Integer	-	Recording file creation date and time (millisecond) Unix timestamp format
`content.recordList.{recordId}.shouldDeleteTime`	Integer	-	Recording file deletion date and time (millisecond) Unix timestamp format
`content.recordList.{recordId}.resolution`	String	-	Resolution `{Width}x{Height}` format
`content.recordList.{recordId}.fileName`	String	-	File name
`content.recordList.{recordId}.duration`	Integer	-	Playback time (millisecond)
`content.recordList.{recordId}.videoBitrate`	Integer	-	Video stream's bitrate (bps)
`content.recordList.{recordId}.audioBitrate`	Integer	-	Audio stream's bitrate (bps)
`content.recordList.{recordId}.videoFrameRate`	Float	-	Number of frames per second (fps)
`content.recordList.{recordId}.audioCodec`	String	-	Audio codec
`content.recordList.{recordId}.uploadPath`	String	-	Directory path
`content.recordList.{recordId}.objectStorageUrl`	String	-	Recording URL If it hasn't been uploaded to the Object Storage bucket, `-` is displayed.
`total`	Integer	-	Total response count

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": {
        "recordList": {
            "270****": {
                "recordType": "MP4",
                "channelId": "ls-20250814******-PZohi",
                "status": "TRANSFER_FINISH",
                "recordSeq": 1307117,
                "streamSeq": 361545,
                "recordBeginTime": 1755496369000,
                "createdTime": 1755496381000,
                "shouldDeleteTime": 1755755581000,
                "resolution": "720x1280",
                "fileName": "361545-1307117-20250818****.mp4",
                "duration": 11634,
                "videoBitrate": 2500000,
                "audioBitrate": 128000,
                "videoFrameRate": 30.0,
                "audioCodec": "aac",
                "uploadPath": "/databucket/361545-1307117-20250818****.mp4",
                "objectStorageUrl": "https://kr.object.ncloudstorage.com/databucket/361545-1307117-20250818****.mp4"
            },
            "270****": {
                "recordType": "HLS",
                "channelId": "ls-20250814******-PZohi",
                "status": "TRANSFER_READY",
                "recordSeq": 1307117,
                "streamSeq": 361545,
                "recordBeginTime": 1755496369000,
                "createdTime": 1755496381000,
                "shouldDeleteTime": 1755755581000,
                "resolution": "720x1280",
                "fileName": "720p-9-16/playlist.m3u8",
                "videoBitrate": 2500000,
                "audioBitrate": 128000,
                "videoFrameRate": 30.0,
                "audioCodec": "AAC",
                "uploadPath": "live-station/record/ls-20250814******-PZohi/720p-9-16/1307117",
                "objectStorageUrl": "-"
            },
            "270****": {
                "recordType": "HLS",
                "channelId": "ls-20250814******-PZohi",
                "status": "TRANSFER_READY",
                "recordSeq": 1307117,
                "streamSeq": 361545,
                "recordBeginTime": 1755496369000,
                "createdTime": 1755496381000,
                "shouldDeleteTime": 1755755581000,
                "resolution": "1920x1080",
                "fileName": "quality000/playlist.m3u8",
                "videoBitrate": 8960000,
                "audioBitrate": 320000,
                "videoFrameRate": 60.0,
                "audioCodec": "AAC",
                "uploadPath": "live-station/record/ls-20250814******-PZohi/quality000/1307117",
                "objectStorageUrl": "-"
            }
        }
    },
    "total": 3
}