List submissions
Returns a paginated list of all clipping submissions for a video, newest first. Use this to audit past runs, find a specific submission ID, or check whether a job is still in progress.
Authorization
apiKey In: header
Path Parameters
Query Parameters
Page number (default: 1)
1 <= valueItems per page (default: 20, max: 100)
1 <= value <= 100Response Body
application/json
application/json
curl -X GET "https://example.com/clips/string/submissions"{ "submissions": [ { "submission_id": "string", "status": "queued", "error_code": "download_failed", "estimated_time": 0, "queue_position": 0, "is_priority": true, "strategy_id": "string", "timeframe": { "start": 0, "end": 0 }, "credit_cost": 0, "is_reclip": true, "clips_count": 0, "created_at": "string", "completed_at": "string" } ], "pagination": { "current_page": 0, "total_pages": 0, "total_count": 0, "has_next_page": true, "has_previous_page": true, "limit": 0 }}Analyze a video POST
Fetches metadata for a public video URL and calculates the exact credit cost before you commit to clipping. No credits are charged. Use this as a pre-flight check before calling `POST /clips`. When `credits_unlimited` is `true`, this workspace is on free usage: `credits_cost` still tells you what the job is worth, but submitting it will not move your balance. Rate-limited to **10 requests per minute** per user.
Get submission GET
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.