Get enhance-video task status

API Reference

Get async task status. When complete, the response includes download_url.

get/v1/videos/enhance/tasks/{task_id}

Authorization — This endpoint requires an API key. Pass it in the api-key header on every request. Learn more

Parameters

Name	Type	Status	Description
`task_id`	string	Required	Task ID returned by the create-task or upload endpoint.

Responses

Task statusAssetTaskStatusResponse

Field	Type	Description
`task_id`	string
`status`	string
`created_at`	integer
`progress`	integer	Progress from 0 to 100.
`started_at`	integer
`completed_at`	integer
`download_url`	string	Signed URL to download the processed video or file when status is `COMPLETED`.
`error_msg`	string	Error message when status is `FAILED`.

curl -X GET "https://api.snapedit.app/v1/videos/enhance/tasks/YOUR_TASK_ID" \
  -H "api-key: YOUR_API_KEY"

Response

{
  "task_id": "task_abc123",
  "status": "COMPLETED",
  "created_at": 1745827200,
  "progress": 100,
  "started_at": 1745827210,
  "completed_at": 1745827300,
  "download_url": "https://storage.googleapis.com/download/result.mp4",
  "error_msg": "string"
}