Media Service

Get video master file (download)

get

https://api.typeform.com/media/videos/{id}/master

Retrieves the processed master video file URL. This endpoint should be polled to check the transcoding status.

Download Process:

After requesting the master file (POST), poll this endpoint to check the transcoding status
When status is "ready", the url field contains the download URL for the processed video
Use the returned URL to download the video file

Status Values:

none: Video master is not yet requested
preparing: Video master is being prepared
ready: Video is ready for download (URL provided)

Polling Recommendations:

Poll every 2-3 seconds initially
After 30 seconds, increase polling interval to 5-10 seconds
Stop polling once status is ready or errored

Note: The download URL is only valid for 24 hours and can be regenerated by calling the POST endpoint again.

Request

Path Parameters

string, required

Unique ID for the video returned from the upload endpoint

Responses

Status

200 Master video status and URL retrieved successfully

Schema

status

string

Valid values:nonepreparingready

Current transcoding status:

none: No master file has been requested
preparing: Upload being prepared
ready: Processing complete, media available for download

url

string

Download URL for the processed media file. Only present when status is "ready". This is a temporary signed URL that should be used promptly.

Example

{
  "status": "ready",
  "url": "https://stream.mux.com/video-id/high.mp4?token=signed-token"
}

Status

401 Unauthorized - invalid or missing authentication token

Schema

code

string

Error code identifying the type of error

details

object

Additional error details specific to the error type

message

string

Human-readable error message

Status

404 Video not found

Schema

code

string

Error code identifying the type of error

details

object

Additional error details specific to the error type

message

string

Human-readable error message