/sapi/transcoding is a read-only endpoint for the purpose of retrieving transcoding status and progress information on a list of clips.
1.0 | Object structure
The status property of a job can be any of the following:
Status | Description |
new | The job is received and yet to be ingested in the transcoding fleet queue |
running | The media has been transferred to the transcoding worker and is being transcoded |
error | There was an error with the transcoding job |
bbqueued | The job has been ingested in the transcoding fleet queue and is waiting for a free worker slot |
transcoded | The job is finished |
The structure below is a JSON representation of a cliplist with the associated transcoding jobs.
Example transcoding job list
{ "type": "cliplist", "items": [ { "id": "1234567", "title": "Example Video", "originalfilename": "Example Video.mp4", "mediajobs": [ { "id": "9876543", "mediajobdefid": "1234", "status": "new", "type": "MediaJob", "totaltime": 19, "timeleft": 538.54545454545, "createddate": "2023-09-20T11:41:37Z" }, { "id": "8765432", "mediajobdefid": "2345", "status": "bbqueued", "type": "MediaJob", "totaltime": 21, "timeleft": 20, "createddate": "2023-09-20T11:41:37Z", "starteddate": "2023-09-20T11:41:41Z" }, { "id": "7654321", "mediajobdefid": "3456", "status": "transcoded", "type": "MediaJob", "totaltime": null, "timeleft": null, "createddate": "2023-09-20T11:32:34Z", "starteddate": "2023-09-20T11:32:39Z", "finisheddate": "2023-09-20T11:32:56Z" }, { "id": "6543210", "mediajobdefid": "4567", "status": "bbqueued", "type": "MediaJob", "totaltime": 19, "timeleft": 19, "createddate": "2023-09-20T11:41:37Z", "starteddate": "2023-09-20T11:41:42Z" }, { "id": "5432109", "mediajobdefid": "5678", "status": "pending", "type": "MediaJob", "totaltime": 8, "timeleft": 7, "createddate": "2023-09-20T11:41:37Z", "starteddate": "2023-09-20T11:41:41Z" }, { "id": "4321098", "mediajobdefid": "6789", "status": "transcoded", "type": "MediaJob", "totaltime": null, "timeleft": null, "createddate": "2023-09-20T11:32:34Z", "starteddate": "2023-09-20T11:32:40Z", "finisheddate": "2023-09-20T11:33:00Z" }, { "id": "3210987", "mediajobdefid": "7890", "status": "running", "type": "MediaJob", "totaltime": 27, "timeleft": 1, "createddate": "2023-09-20T11:32:34Z", "starteddate": "2023-09-20T11:32:40Z" }, { "id": "2109876", "mediajobdefid": "8901", "status": "transcoded", "type": "MediaJob", "totaltime": null, "timeleft": null, "createddate": "2023-09-20T11:32:34Z", "starteddate": "2023-09-20T11:32:40Z", "finisheddate": "2023-09-20T11:32:57Z" } ] } ] }
2.0 | Params
By default a limit of 15 is applied for clips created in the last 12 hours.
Parameters | Description | Example |
sort | (string fieldname string direction) determine sorting field and direction (default is id desc) | ?sort=title asc |
limit | (integer) determine the number of mediaclips to return | ?limit=100 |
offset | (integer) determine an offset to start the list | ?offset=100 |
mediaclipid | (integer) only show results for a specific clip | ?mediaclipid=1234567 |
date-ingested | don’t show clips that have been uploaded before this date | ?date-ingested=yyyy-mm-dd ?date-ingested=-10 days |