Get Video Status
This endpoint will retrieve the current status of a specific video during upload and when upload is complete.
To know whether a video is fully processed, including transcoding, use the field isProcessing along with with status state that is returned in the response. For example, if the value of isProcessing is false and the status is Ready, then the video has been fully processed. If the value of isProcessing is true and status is Ready, then it means the video is available for playback but the transcoding process is still in progress.
The progress of the overall processing of the video can be tracked using the field overallProgress whose value ranges from 0.0 to 1.0 where 1.0 means that the processing is 100% completed.
Possible status states during upload are:
- NotUploaded
- Uploading
- UploadingFinished
- Ingesting
- Processing
Possible final status states once upload is complete are:
- Canceled
- UploadFailed
- ProcessingFailed
- Ready
- ReadyButProcessingFailed
Path Parameters
| Parameter | Type | Validations |
|---|---|---|
| videoId | string, required | ID of the video to retrieve status state |
Request Body
REQUEST: Get Video Status
curl -X GET
https://REVURL/api/v2/videos/f63b69c8-3646-4350-a8e7-df263aa96f9f/status
-H 'Authorization: VBrick EYmIJUI-ia6_xLGY4MoC6LvoHG45y5xuJJ9wVgA4rheZTztQpJIAHdXrivqcYWKiJqPIS39WwHUpQY4OMwNU4N2g5b-Hf5JVa7OCcON04Zwvf3LGrtQVg34-AxbIG3Ft5YTcvFQqGLIL4auFA-sXEw2'
-H 'Cache-Control: no-cache'
-H 'Postman-Token: 621cedd7-fc8f-424d-8138-61a66da69b3a'
Response Body
successful response
videoStatus {
videoId (string, optional),
title (string, optional),
status (string, optional),
isProcessing (boolean, optional),
overallProgress (double, optional),
isActive (boolean, optional),
uploadedBy (string, optional),
whenUploaded (string, optional)
}
Unauthorized error
Internal server error