Use the /sapi/transcoding endpoint (read-only) to retrieve transcoding status and progress information for clips.
1.0 | Transcoding Object
The status property of a job can be any of the following:
| Status | Description |
|---|---|
new | The job has been received and is yet to be ingested into the transcoding fleet queue. |
bbqueued | The job has been ingested into the transcoding fleet queue and is waiting for a free worker slot. |
pending | The job is queued on the transcoding worker and waiting to start. |
running | The media has been transferred to a transcoding worker and is being transcoded. |
transcoded | The job is finished. |
error | There was an error with the transcoding job. |
The structure below is a JSON representation of a clip list 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 | Parameters
By default, a limit of 15 is applied for clips created in the last 12 hours.
| Parameter | Description | Example |
|---|---|---|
| sort | (string) Field name and direction to sort by. Default is id desc. | ?sort=title asc |
| limit | (integer) Number of media clips to return. | ?limit=100 |
| offset | (integer) Offset to start the list from. | ?offset=100 |
| mediaclipid | (integer) Only show results for a specific clip. | ?mediaclipid=1234567 |
| date-ingested | Do not show clips uploaded before this date. Accepts a date or a relative value. | ?date-ingested=yyyy-mm-dd?date-ingested=-10 days |