Retrieve combined video link

Retrieve the link to download a combined video requested with POST /devices/{imei}/events/{eventId}/combined-video. The link is valid for 24 hours, or until the combined video is deleted if that is sooner (see urlExpiresAt); each call returns a new link.

  • While the job is in progress, or when it did not complete (FAILED, CANCELLED or DEADLINE_EXCEEDED), a 400 response explains why. A job in progress is usually completed within a few minutes.

  • A 404 response means the job does not exist for this device, or the combined video is no longer kept: it is deleted when its event is purged, and at most 30 days after it was created.

Request
Security:
bearerAuth
path Parameters
imei
required
string (IMEI)

The IMEI of the device. The IMEI number can be found on a sticker on the device itself or on the back of the device box.

Example: 357660101000198
jobId
required
string

The job ID returned by POST /devices/{imei}/events/{eventId}/combined-video.

Example: 3f1c2a64-8d3e-4f0a-9b7e-2c5d1e6f7a80
Responses
200

The link to download the combined video.

400

Bad request error

401

Unauthorized error

403

Forbidden error

404

Not found error

429

Too many requests error - try again later

500

Internal server error

get/devices/{imei}/combined-video/{jobId}
Request samples
curl -i -X GET \
  https://api-prod.surfsight.net/v2/devices/:imei/combined-video/:jobId \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
Response samples
    2 more
    429
    500
application/json
{
  • "data": {
    },
  • "requestId": "06327cae-e075-42ca-b620-c5cfdd3b4e37"
}