---
title: "List Agent Leads"
method: GET
path: "/api/agents/{agent_id}/leads"
---

# List Agent Leads

`GET /api/agents/{agent_id}/leads`

## Request

- Base URL: `https://api.outcallerai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.outcallerai.com/api/agents/{agent_id}/leads`
- Auth: none declared

## Path parameters

- `agent_id` string, required

## Query parameters

- `page` integer
- `pageSize` integer
- `search` string
- `include_calls` boolean
- `source` string, nullable
- `use_case_id` string, nullable
- `sort_dir` 'asc' | 'desc'

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-17** `b44a22c97294`: 1 info
  - added the new optional `query` request parameter `sort_dir`
- **2026-07-31** `7c9aff2501f3`: 1 warning, 1 info
  - deleted the `query` request parameter `campaign_id`
  - added the new optional `query` request parameter `use_case_id`

[Operation history](https://skmtc.dev/outcallerai/apis/outcallerai-api/changes/api/agents/:agent_id/leads/get.md)

---

[API](https://skmtc.dev/outcallerai/apis/outcallerai-api.md) - [All operations](https://skmtc.dev/outcallerai/apis/outcallerai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/outcallerai/apis/outcallerai-api/revisions/40736cf433b4?raw)