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").
Action the task relates to (UUID), if any.
Company that owns the task.
When the task finished (ISO 8601), if terminal.
When the task was created (ISO 8601).
Error detail when status is "failed".
Items that failed.
Task ID (UUID) — the taskId returned by the operation that started the task.
List the task operates on (UUID), if any.
Server node processing the task.
Items processed so far.
Human-readable progress note.
processedItems / totalItems as a percentage (0 when total is unknown).
Task-specific result payload, populated when completed (shape depends on taskType).
When processing began (ISO 8601), if started.
Current status: "pending", "running", "completed", "failed", or "cancelled". The first two are non-terminal — keep polling; the last three are terminal.
Items processed successfully.
Task-specific input/config (e.g. the columnNames a dedup ran on).
Kind of task, e.g. "Deduplicate", "import", "people_search".
Total items the task will process (0 until known).
Last update (ISO 8601).
User who started the task.

