---
title: "Your saved leads: companies, people and jobs, filterable by type and lead list (?list=)."
method: GET
path: "/v1/leads"
tags: ["Your leads"]
---

# Your saved leads: companies, people and jobs, filterable by type and lead list (?list=).

`GET /v1/leads`

## Request

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

Your saved leads: companies, people and jobs, filterable by type and lead list (?list=).

Free.

MCP tool: `list_leads`.

## Query parameters

- `type` 'company' | 'person' | 'job' | 'post'
- `list` string
- `limit` integer
- `page` integer
- `offset` integer

## Response `200`

OK

- object
  - `total` integer
  - `page` integer
  - `limit` integer
  - `data` object[]
    - `type` 'company' | 'person' | 'job' | 'post'
    - `ref` string
    - `saved_at` string, nullable

## Other responses

- `400`: Invalid input (`bad_request`).
- `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)