Request one video that combines several cameras of an event, arranged in a layout. The combined video download feature must be enabled for your account.

The response is the jobId of the video: the job that created it when the video already exists, the job in progress when an identical request was already made, or a new job. Get the download link with GET /devices/{imei}/combined-video/{jobId} once the job is completed.

When the job ends, a system message webhook of type combinedVideo is sent if the combinedVideo setting is enabled in the device system messages webhook settings. It contains the jobId, status (COMPLETED, FAILED, CANCELLED or DEADLINE_EXCEEDED), cameraIds, layout (the layout name, also when the default was used) and startingTime.

• For COMPLETED, it also contains the fileSize in bytes and, when known, the duration in seconds, width, height and completedAt.


• Otherwise it contains an errorCode: SOURCE_MEDIA_MISSING, SOURCE_MEDIA_CORRUPT, LENS_COVERAGE_GAP (the cameras do not record the same period), INPUT_TOO_LARGE, INVALID_REQUEST, DEADLINE_EXCEEDED or INTERNAL_ERROR.

Without the webhook, call GET /devices/{imei}/combined-video/{jobId}: it answers 400 until the job is completed.

The cameras are aligned by their capture time. The video runs from the earliest camera start to the latest camera end, and a camera that starts later or ends earlier is shown as black for those few seconds. Audio is taken from the first camera in cameraIds that has an audio track.