Videos
Get Video Details
Get detailed information about a specific video
GET
Overview
This endpoint retrieves comprehensive details about a specific video, including status, URL, duration, and metadata. Use this to monitor individual video progress or retrieve video information for display.This endpoint requires authentication and only returns videos that belong to your team.
Path Parameters
The unique identifier of the video to retrieve
Response Fields
Indicates if the request was successful
Status message
Error Responses
Status Codes
| Status | Code | Description |
|---|---|---|
| Success | 200 | Video found and details returned |
| Not Found | 404 | Video doesn’t exist |
| Forbidden | 403 | Video belongs to another team |
| Unauthorized | 403 | Invalid or missing API key |
| Server Error | 500 | Internal server error |
Video Status States
STARTED
STARTED
Video is currently being processed. The
progress field shows the current percentage.COMPLETED
COMPLETED
Video processing finished successfully. The
url field contains a signed URL to download the video. URL is valid for 24 hours.FAILED
FAILED
Video processing failed. Check the
message field for details about what went wrong.Downloading Videos
Once a video has statusCOMPLETED, the url field provides a signed S3 URL:
Download Example
Polling for Completion
To monitor video progress, you can poll this endpoint:Polling Example
Better approach: Use webhooks instead of polling. See Video Webhook for details.
Use Cases
Progress Tracking
Monitor video rendering progress
Download Management
Get download URLs for completed videos
Status Display
Show video status in your dashboard
Error Handling
Detect and handle rendering failures
Related Endpoints
List Videos
View all videos
Create Video
Create a new video
Video Webhook
Handle video completion notifications
Authorizations
Path Parameters
Video ID
Response
Video details retrieved successfully
Unique video identifier
Video name/title
Current video processing status
Available options:
STARTED, COMPLETED, FAILED Signed URL to download the video (only available when status is COMPLETED)
Duration of the video in frames (at 25fps)
Duration of the video in seconds (calculated from durationInFrames)
Associated project ID if video belongs to a project
Team ID that owns this video
URL to video thumbnail image
Video file size in bytes
Processing progress percentage (0-100)
Required range:
0 <= x <= 100Status message or error details
Video creation timestamp
Last update timestamp