---
title: "Query working leads (paginated)"
method: GET
path: "/v2.0/working-leads"
tags: ["Sales Agents V2"]
---

# Query working leads (paginated)

`GET /v2.0/working-leads`

Retrieves a paginated list of leads currently being followed up by AI Sales Agent. Supports filtering by AI stage (HIGH_PRIORITY, AI_PROSPECTING, AI_MONITORING). Returns lead basic info with AI stage, task counts, and timestamps.

## Query parameters

- `aiStage` string — AI follow-up stage filter (HIGH_PRIORITY, AI_PROSPECTING, AI_MONITORING)
- `limit` string — Page size (max 100)
- `offset` string — Start index of the responded leads
- `sort` string — Sort field (Default, CreateTime, UpdateTime)
- `desc` string — Descending sort (true) or ascending sort (false)

## Headers

- `Authorization` string, required

## Response `200`

Working leads retrieved successfully

- WorkingLeadListResponseV2 — Working lead list response with pagination
  - `workingLeads` WorkingLeadV2[] — List of working leads
    - `leadId` integer — Lead ID
    - `firstName` string — First name
    - `lastName` string — Last name
    - `email` string — Email address
    - `phone` string — Phone number
    - `createdAt` string — Created timestamp (ISO8601)
  - `metadata` PaginationMetadata — Pagination metadata
    - `total` integer — Total count of working leads matching the query
    - `count` integer — Count of leads in current response
    - `offset` integer — Offset of the current page
    - `limit` integer — Page size limit

## Other responses

- `400` — Invalid parameters (e.g., limit > 100, invalid aiStage).
- `401` — Missing or invalid authentication token.
- `500` — Internal server error.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/versions/23e640467118/schema)