Get submission

Returns the current status of a clipping submission. Poll this endpoint until status is completed or failed.

We recommend polling every 5–10 seconds. When status is queued, use queue_position and estimated_time to give feedback to your users.

GET /clips/{videoId}/submissions/{submissionId}

Get submission

cURL

curl --request GET \
  --url https://api.cut.pro/api/v1/clips/{videoId}/submissions/{submissionId} \
  --header 'X-Api-Key: <api-key>'

200

{
  "submission_id": "<string>",
  "video_id": "<string>",
  "clips_count": 123,
  "queue_position": 123,
  "estimated_time": 123,
  "created_at": "<string>",
  "completed_at": "<string>"
}

Authorizations

X-Api-Key · string · header · required

Path Parameters

videoId · string · required

submissionId · string · required

Response

200

application/json

Response for status 200

submission_id · string · required

Unique submission ID

video_id · string · required

ID of the source video

status · enum<string> · required

Available options: queued, downloading, transcribing, analyzing, finalizing, completed, failed

error_code · Option 1 · enum<string> Option 2 · enum<string> Option 3 · enum<string> Option 4 · enum<string> Option 5 · enum<string> Option 6 · enum<string> Option 7 · enum<string> Option 8 · enum<string> Option 9 · enum<string> Option 10 · enum<string> Option 11 · enum<string> Option 12 · enum<string> · required

Available options: download_failed

clips_count · number · required

Number of AI-generated clips available; only meaningful when status is completed

queue_position · number | null · required

Position in the processing queue; null once processing has started

estimated_time · number | null · required

Estimated seconds until completion; null once processing has started

created_at · string · required

ISO 8601 timestamp of when this submission was created

completed_at · string | null · required

ISO 8601 timestamp of when this submission finished, or null if still running