---
title: "List leads"
method: GET
path: "/leads"
tags: ["Leads"]
---

# List leads

`GET /leads`

Returns a cursor-paginated list of the caller-owned leads, newest first. Filter by stage, type, contact email, and creation date.

## Query parameters

- `limit` integer — Page size, 1 to 100.
- `starting_after` string — Return the page after this resource id (newest first).
- `stage` 'new' | 'to_reach_out' | 'engaged' | 'needs_attention' | 'booked' | 'on_hold' | 'closed_won' | 'closed_lost' — Filter to a single lead stage.
- `type` 'partial_order' | 'partial_preorder' | 'rejected_financing' | 'buy_in_person' | 'inquiry' | 'conversation' | 'pre_qual' | 'external_crm' — Filter to a single lead type.
- `email` string — Exact-match contact email; backs the find-lead search.
- `created[gte]` integer, nullable — Only leads created at or after this epoch ms.
- `created[lte]` integer, nullable — Only leads created at or before this epoch ms.

## Response `200`

A page of leads.

- object
  - `data` Lead[], required — unresolved $ref
  - `has_more` boolean, required — True when another page follows the returned one.
  - `next_cursor` string, nullable, required — Pass as `starting_after` to fetch the next page; null when `has_more` is false.

## Other responses

- `400` — The request was malformed or failed validation.
- `401` — Authentication is missing or invalid.
- `403` — The token lacks a required scope.
- `429` — The rate limit has been exceeded.
- `500` — An unexpected error occurred.

---

[API](https://skmtc.dev/ekho/apis/ekho-api.md) · [All operations](https://skmtc.dev/ekho/apis/ekho-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ekho/ekho-api/revisions/2056332cf6b9/schema)