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.

A submission can sit at downloading because the SOURCE is not fully published yet — a scheduled premiere, a livestream still on air, or a recording the platform is still processing. In that case waiting_reason is set (and waiting_until carries the announced start time, when the platform provides one). This is not an error and the submission is not stuck: it resumes on its own once the source becomes available. Surface it to your users instead of a generic "downloading", and offer them the option to cancel — DELETE /v1/clips/{videoId}/submissions/{submissionId} refunds the credits while waiting_reason is set.

Path Parameters

Response Body

curl -X GET "https://example.com/clips/string/submissions/string"

{  "submission_id": "string",  "video_id": "string",  "status": "queued",  "error_code": "download_failed",  "clips_count": 0,  "queue_position": 0,  "estimated_time": 0,  "waiting_reason": "source_premiere_scheduled",  "waiting_until": "string",  "created_at": "string",  "completed_at": "string"}