---
title: "Get background task status"
method: GET
path: "/tasks/{task_id}"
tags: ["Tasks"]
---

# Get background task status

`GET /tasks/{task_id}`

Return the live status for a background task started by list operations Use the `task_id` returned by the create endpoint.

**Usage**
Poll this endpoint every 1s until `completed=true`. If the task is unknown or expired, the service returns `completed=true` with no totals, which can be treated as finished.

## Path parameters

- `task_id` string, required — Background task id returned by the create endpoint.

## Response `200`

Task status returned successfully.

- TaskStatusOut
  - `task_id` string, required
  - `running` boolean, required
  - `completed` boolean, required
  - `total` integer, nullable
  - `updated` integer, nullable
  - `version_conflicts` integer, nullable

## Other responses

- `400` — Invalid task_id format.
- `401` — Authentication required.
- `404` — Task not found.
- `422` — Validation Error

---

[API](https://skmtc.dev/leakradar/apis/leakradar-io-api.md) · [All operations](https://skmtc.dev/leakradar/apis/leakradar-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/leakradar/leakradar-io-api/revisions/82a99c608e1a/schema)