---
title: "List your Unlocked Lists"
method: GET
path: "/profile/unlocked/lists"
tags: ["Unlocked Leaks Lists"]
---

# List your Unlocked Lists

`GET /profile/unlocked/lists`

## Request

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

Return all your Unlocked Lists in ascending creation order.

Parameters
- `with_counts` when true, each list includes `items_count`, the number of unlocked leaks currently assigned to that list. When false, `items_count` is returned as 0 to avoid extra computation.

**Errors**
- 401 Authentication required, or invalid/expired API key.
- 422 Request validation error.

## Query parameters

- `with_counts` boolean: When true, include `items_count` per list.
- `dataset` 'stealer_logs' | 'combolist': Dataset used to compute each list's item count.

## Response `200`

Lists returned successfully.

- UnlockedListOut[]
  - `id` integer, required
  - `name` string, required
  - `color` string, nullable, required
  - `created_at` string, nullable, required
  - `updated_at` string, nullable, required
  - `items_count` integer, nullable

## Other responses

- `401`: Authentication required, or invalid/expired API key.
- `422`: Validation Error

## Changes

- **2026-09-04** `eb219e94d077`: 1 info
  - added the new optional `query` request parameter `dataset`
- **2026-09-01** `82a99c608e1a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/leakradar/apis/leakradar-io-api/changes/profile/unlocked/lists/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)