Leads

List Leads

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
get/leads/

Query parameters

limitinteger
offsetinteger
is_qualifiedboolean nullable

Filter by qualification status

Filter by qualification status

case_idstring uuid nullable

Filter by case ID

Filter by case ID

client_statusstring nullable

Filter by client status

Filter by client status

searchstring nullable

Search by name, phone, email, or inquiry reason

Search by name, phone, email, or inquiry reason

lead_scorestring nullable

Filter by lead score (low, medium, high, unknown)

Filter by lead score (low, medium, high, unknown)

Response

Successful Response

totalinteger required
limitinteger required
offsetinteger required

Changes