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

# List leads

`GET /api/partner/leads`

List all leads created by this partner, ordered newest-first. Optionally filter by stage.

## Query parameters

- `stage` string, nullable — Filter by stage (e.g. Prequalified, Intake, Quoted)

## Response `200`

Successful Response

- LeadListResponse
  - `success` boolean
  - `data` LeadData[], required
    - `lead_id` string, required — Unique identifier for the lead.
    - `contact_name` string, required
    - `contact_email` string, required
    - `company_name` string, required
    - `stage` string, required — Pipeline stage the lead is in.
    - `created_at` string, required
    - `is_existing` boolean, required — True if a lead with this email already existed and was returned instead of created.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/riskcube/apis/slack-lead-manager.md) · [All operations](https://skmtc.dev/riskcube/apis/slack-lead-manager/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/riskcube/slack-lead-manager/revisions/4442bbae8296/schema)