---
title: "Fetch all leads"
method: GET
path: "/api/v1/leads"
tags: ["Leads"]
---

# Fetch all leads

`GET /api/v1/leads`

## Request

- Base URL: `https://api.checkcherry.com`
- URL: `https://api.checkcherry.com/api/v1/leads`
- Auth: none declared. Required headers: `Api-Key`

Returns a paginated list of leads for the specified business. Results can be filtered by email address for exact matching, or by a text query that performs a full-text search across lead names, email, phone, venue, and notes.

Each lead includes booking details (event date, start/end time, length, package name, service name) from its primary lead booking, flattened directly into the lead attributes.

Use the `include` query parameter to sideload related resources (comma-separated). Available: `lead_bookings`.

The response includes `meta.total_count` (total matching leads) and `meta.per_page` (results per page) to support pagination.

**Required permission:** `lead_read`

## Query parameters

- `include` string
- `email` string
- `text` string
- `page` integer
- `per` integer

## Headers

- `Api-Key` string, required

## Response `200`

leads found

---

[API](https://skmtc.dev/checkcherry/apis/check-cherry-business-api.md) · [All operations](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/revisions/84a9aabdf519?raw)