Get the status of a background task by its taskId.
Use this to poll an asynchronous operation (e.g. deduplication) that
returned a taskId. Re-fetch until status is terminal — “completed”,
“failed”, or “cancelled” (“pending” and “running” mean keep polling.)
Authorizations
Company API key - scoped to a specific company. Generate from the Integrations page in your dashboard.
Path Parameters
Response
Current status of the background task
Status of an asynchronous background task (e.g. a deduplication or import). Poll until status is a terminal value: "completed", "failed", or "cancelled" (non-terminal: "pending", "running").
Task ID (UUID) — the taskId returned by the operation that started the task.
Company that owns the task.
User who started the task.
List the task operates on (UUID), if any.
Action the task relates to (UUID), if any.
Kind of task, e.g. "Deduplicate", "import", "people_search".
Current status: "pending", "running", "completed", "failed", or "cancelled". The first two are non-terminal — keep polling; the last three are terminal.
Total items the task will process (0 until known).
Items processed so far.
Items processed successfully.
Items that failed.
processedItems / totalItems as a percentage (0 when total is unknown).
Human-readable progress note.
Error detail when status is "failed".
Task-specific result payload, populated when completed (shape depends on taskType).
Task-specific input/config (e.g. the columnNames a dedup ran on).
Server node processing the task.
When the task was created (ISO 8601).
When processing began (ISO 8601), if started.
When the task finished (ISO 8601), if terminal.
Last update (ISO 8601).

