---
title: "Your lead lists and how many leads each holds."
method: GET
path: "/v1/lead-lists"
tags: ["Your leads"]
---

# Your lead lists and how many leads each holds.

`GET /v1/lead-lists`

## Request

- Base URL: `https://linkfetch.io`
- URL: `https://linkfetch.io/v1/lead-lists`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Your lead lists and how many leads each holds.

Free.

MCP tool: `list_lead_lists`.

## Response `200`

OK

- object
  - `data` object[]
    - `id` string
    - `name` string
    - `leads` integer
    - `flow_id` string, nullable
    - `updated_at` string, nullable

## Other responses

- `401`: Missing, invalid or revoked API key (`unauthorized`).
- `default`: Other errors: 409 account session needs attention, 428 no connected account (`no_account`), 501 not in the API yet (`coming_soon`), 502 LinkedIn failed (`upstream`), 503 `unavailable`, 500 `internal`.

---

[API](https://skmtc.dev/linkfetch/apis/linkfetch-api.md) · [All operations](https://skmtc.dev/linkfetch/apis/linkfetch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/linkfetch/apis/linkfetch-api/revisions/b83d21f70fcb?raw)