Task Status

GET/v1/tasks/{task_id}

Poll the task until status is completed or failed. Recommended interval: 3–5 seconds.

Response Example

{
  "task_id": "xKj9aP3qLm7v",
  "status": "completed",
  "progress": 100,
  "product": "YOUR_PRODUCT_SLUG",
  "country": "CN",
  "total": 5000,
  "processed": 5000,
  "valid": 3800,
  "invalid": 1200,
  "unknown": 0,
  "cost_deducted": "0.500000",
  "cost_refunded": "0.000000",
  "result_available": true,
  "result_expires_at": "2026-05-02T10:00:00+00:00",
  "created_at": "2026-05-01T10:00:00+00:00"
}

Task Status Values

status	Description
pending	Queued and waiting for resources.
processing	Detection is in progress.
completed	Completed. The result is ready to download.
failed	Execution failed.