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

# List Leads

`GET /leads/`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/leads/`
- Auth: none declared

List leads for the current user's customer.

Returns leads ordered by created_at descending (newest first).
Supports filtering by:
- is_qualified: True (qualified) or False (not qualified)
- case_id: Filter by matched case
- client_status: existing_client, new_client, unknown
- search: Search across name, phone, email, inquiry reason
- lead_score: low, medium, high

## Query parameters

- `limit` integer
- `offset` integer
- `is_qualified` boolean, nullable: Filter by qualification status
- `case_id` string, uuid, nullable: Filter by case ID
- `client_status` string, nullable: Filter by client status
- `search` string, nullable: Search by name, phone, email, or inquiry reason
- `lead_score` string, nullable: Filter by lead score (low, medium, high, unknown)

## Response `200`

Successful Response

- LeadListResponse: Response for listing leads with pagination.
  - `leads` LeadWithCaseResponse[], required
    - `lead_id` string, uuid, nullable
    - `outbound_lead_id` string, uuid, nullable
    - `customer_id` string, uuid, required
    - `call_id` string, uuid, nullable
    - `conversation_id` string, uuid, nullable
    - `form_session_id` string, uuid, nullable
    - `case_id` string, uuid, nullable
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `phone_number` string, nullable
    - `email` string, nullable
    - `address` string, nullable
    - `client_status` string, required
    - `is_qualified` boolean
    - `qualification_summary` string, nullable
    - `qualification_details` QualificationQA[], nullable
      - `question` string, required: The qualification question that was asked or evaluated
      - `answer` string, required: The caller's answer or the evaluated response from the transcript
    - `lead_score` string, nullable
    - `lead_score_reasoning` string, nullable
    - `custom_score_output` object, nullable
    - `inquiry_reason` string, nullable
    - `is_urgent` boolean, nullable
    - `urgency_reasoning` string, nullable
    - `matter_name` string, nullable
    - `subject_line` string, nullable
    - `lead_source` string, nullable
    - `notification_emails_sent` boolean
    - `notification_sms_sent` boolean
    - `skip_notifications` boolean
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, nullable
    - `case_title` string, nullable
    - `call_created_at` string, date-time, nullable
    - `event_at` string, date-time, nullable
    - `call_direction` string, nullable
    - `is_test` boolean
    - `outbound_status` string, nullable
    - `pp_contact_guid` string, nullable
    - `pp_matter_guid` string, nullable
    - `pp_matter_name` string, nullable
    - `info_request_sms_sent` boolean
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-09** `d61063451a04`: 1 info
  - added the optional property `leads/items/address` to the response with the `200` status
- **2026-09-27** `943230ee859e`: 1 info
  - added the optional property `leads/items/outbound_status` to the response with the `200` status
- **2026-09-15** `a208ca0461de`: 2 info
  - added the optional property `leads/items/is_urgent` to the response with the `200` status
  - added the optional property `leads/items/urgency_reasoning` to the response with the `200` status
- **2026-09-07** `b883e03846c6`: 1 info
  - added the optional property `leads/items/event_at` to the response with the `200` status

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

---

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