record.file.list: Get local recordings

record.file.list · channel scope · permission RecordReplay

What it does

Local recordings: fetches the local recording file list for this channel by time (not player playback control). Input beginTime, endTime, type, and limit (30–100). sessionId is optional; if the previous response included sessionId, you may send it on the next call to optimize the query—it is not a pagination token. Paginate with beginTime, endTime, and limit by sliding the time window. Returns up to 100 records. Do not mix with legacy queryLocalRecords count/queryRange. Each call runs once. type enums follow this page’s table (includes 17 vlog, 21 localRecord). Count and bitmap do not allow the exact same set (e.g. count omits 21, bitmap omits 17). Trust device.capability.list and each leaf’s table.

Routing: externally unified v2 device.service.invoke; on some devices the platform maps to device-side Open-OPS (e.g. record/list). The open platform does not proxy queryLocalRecords again. Devices that list this service in device.capability.list use invoke. For playback, see SDK/player docs.

Request URL

POST https://openapi-[DataCenter].easy4ip.com/openapi/v2/device.service.invoke

Minimum permission

The administrator does not need an extra permission on a device they bound. A shared device needs the local recording view permission. A bound sub-user does not. A sub-account needs RecordReplay. Omitting channelId on channel-scope capabilities returns DV2007. Mixing device and channel properties in one request returns DV2008. A timeout does not mean the invoke failed.

Request parameters

For common request fields and signing, see Signing conventions and Common request payload.

Request example

{
 "id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af",
 "system": {
 "ver": "1.0",
 "appId": "lcdxxxxxxxxx",
 "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
 "time": 1706511734,
 "nonce": "f5a1ae2d-c09c-4d39-a744-83a5c2c653c2"
 },
 "params": {
 "token": "<yourAccessToken>",
 "deviceId": "TESTIPC000012345",
 "channelId": "0",
 "serviceId": "record.file.list",
 "inputData": {
 "type": "0",
 "beginTime": "2026-09-19 00:00:00",
 "endTime": "2026-09-19 23:59:59",
 "limit": 30
 }
 }
}

Response data fields

Output is in result.data.outputData.

Response example

{
 "id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af",
 "result": {
 "code": "0",
 "msg": "Operation is successful",
 "data": {
 "outputData": {
 "sessionId": "s-1",
 "records": [
 {
 "fileName": "rec-1",
 "fileLength": 1024,
 "type": "1",
 "streamType": "0",
 "beginTime": "2026-09-19 08:00:00",
 "endTime": "2026-09-19 08:10:00",
 "localBeginTime": "2026-09-19 08:00:00",
 "localEndTime": "2026-09-19 08:10:00",
 "objectType": "",
 "xseq": 1,
 "multiType": "",
 "picId": 0
 }
 ]
 }
 }
 }
}

Error codes

See Return codes · OP/SN/TK for the full catalog.

See Capability errors.

Local recordings