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

# List your leads

`GET /api/v1/leads`

## Request

- Base URL: `https://replyatlas.com`
- URL: `https://replyatlas.com/api/v1/leads`
- Auth: HTTP bearer

People who've engaged with your automations, with lead score, sentiment, and conversion status. Filter by handle, score range, sentiment, or conversion. Available on any plan with API access — note that **API access itself requires Pro or Pro+**.

## Query parameters

- `cursor` string
- `limit` integer
- `q` string
- `minScore` integer
- `maxScore` integer
- `sentiment` 'POSITIVE' | 'NEUTRAL' | 'NEGATIVE'
- `converted` boolean

## Response `200`

Page of Lead

- Page
  - `items` object[]
  - `nextCursor` string, nullable

---

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