---
title: "List leads with optional filters"
method: GET
path: "/api/leads"
---

# List leads with optional filters

`GET /api/leads`

## Request

- Base URL: `https://lead-radar.fr`
- URL: `https://lead-radar.fr/api/leads`
- Auth: HTTP bearer

## Query parameters

- `page` integer
- `limit` integer
- `searchId` string
- `hasEmail` boolean
- `hasWebsite` boolean
- `q` string
- `tagId` string

## Response `200`

Paginated leads

- object
  - `data` Lead[]
    - `id` string
    - `name` string
    - `address` string, nullable
    - `phone` string, nullable
    - `website` string, nullable
    - `email` string, nullable
    - `emailStatus` 'NOT_ATTEMPTED' | 'PROCESSING' | 'FOUND' | 'NOT_FOUND' | 'ERROR'
    - `rating` number, nullable
    - `reviewCount` integer, nullable

---

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