Skip to Content

Get Task Status

Query the execution status and result of an asynchronous task.

Endpoint

GET https://123api.co/v1/tasks/{task_id}

Example

curl --request GET \
  --url https://123api.co/v1/tasks/YOUR_TASK_ID \
  --header 'Authorization: Bearer <token>'

Example with language parameter

curl --request GET \
  --url 'https://123api.co/v1/tasks/YOUR_TASK_ID?language=en' \
  --header 'Authorization: Bearer <token>'

Common Response States

StatusMeaning
queuedTask accepted and waiting
processingTask is being executed
completedTask finished successfully
failedTask failed and needs inspection

Typical Response

{
  "task_id": "task-unified-123456",
  "status": "completed",
  "result": {
    "url": "https://example.com/final-asset.png"
  }
}

Poll at a fixed interval such as 2 to 5 seconds, and stop polling as soon as the task reaches a terminal state.