Retrieve the status and result of an async task. Poll this endpoint after creating a task. Auto-fails tasks with CREATED status older than 120 seconds.
/v1/tasks/{task_id}Authorization — This endpoint requires an API key. Pass it in the api-key header on every request. See the quickstart
| Name | Type | Status | Description |
|---|---|---|---|
task_id | string | Required | The task ID returned from the create task endpoint. |
Task status retrievedTaskStatusResponse
| Name | Type | Description |
|---|---|---|
task_id | string | |
status | string | |
progress | integer | Progress 0-100 (when PROCESSING) |
output_image_url | string | Result image URL (when COMPLETED) |
error_msg | string | Error message (when FAILED) |
created_at | integer | |
started_at | integer | |
completed_at | integer |
curl -X GET "https://api.snapapi.ai/v1/tasks/YOUR_TASK_ID" \
-H "api-key: YOUR_API_KEY"{
"task_id": "task_abc123",
"status": "COMPLETED",
"progress": 75,
"output_image_url": "https://outputs.snapapi.ai/outputs/result.png",
"error_msg": "string",
"created_at": 0,
"started_at": 0,
"completed_at": 0
}