---
title: "Get unlocked lists background task status"
method: GET
path: "/profile/unlocked/list-tasks/{task_id}"
tags: ["Unlocked Leaks Lists"]
---

# Get unlocked lists background task status

`GET /profile/unlocked/list-tasks/{task_id}`

## Request

- Base URL: `https://api.leakradar.io`
- URL: `https://api.leakradar.io/profile/unlocked/list-tasks/{task_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/leakradar/apis/leakradar-io-api/docs/profile/unlocked/list-tasks/:task_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Return the status of a background task started by unlocked lists operations.

This endpoint is only for tasks created by:
- `POST /profile/unlocked/lists/bulk-assign` (bulk assign/unassign list)

Usage
- Use the exact `task_id` returned by one of these endpoints.

Important
- Do **not** use this endpoint for unlock tasks created by `/search/.../unlock/task`. For unlock tasks, poll `/tasks/{task_id}` instead.

## Path parameters

- `task_id` string, required: Task id returned by an unlocked-lists operation (delete / clear / bulk).

## Response `200`

Task status returned.

- 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 for this endpoint (use /tasks/{task_id} for unlock tasks).
- `401`: Authentication required, or invalid/expired API key.
- `422`: Validation Error

## Changes

- **2026-09-01** `82a99c608e1a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/leakradar/apis/leakradar-io-api/changes/profile/unlocked/list-tasks/:task_id/get.md)

---

[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.dev/leakradar/apis/leakradar-io-api/revisions/8dcd4b54cc4a?raw)