---
title: "Leads"
url: https://docs.light-ai.app/api-reference/leads.md
canonical_url: https://docs.light-ai.app/api-reference/leads
last_updated: 2026-10-13
summary: "Inbound estimate requests from every channel, deduplicated into touches."
api_status: beta
related:
  - https://docs.light-ai.app/api-reference
---

# Leads

> Inbound estimate requests from every channel, deduplicated into touches.

Inbound estimate requests from every channel, deduplicated into touches.

- `GET /v1/leads`: [List leads](https://docs.light-ai.app/api-reference/leads/list-leads.md)
- `POST /v1/leads`: [Create a lead](https://docs.light-ai.app/api-reference/leads/create-lead.md)
- `POST /v1/leads/search`: [Search leads by email, phone or address](https://docs.light-ai.app/api-reference/leads/search-leads.md)
- `GET /v1/leads/{lead_id}`: [Retrieve a lead](https://docs.light-ai.app/api-reference/leads/get-lead.md)
- `PATCH /v1/leads/{lead_id}`: [Update a lead](https://docs.light-ai.app/api-reference/leads/update-lead.md)
- `GET /v1/leads/{lead_id}/touches`: [List the repeat requests folded into a lead](https://docs.light-ai.app/api-reference/leads/list-lead-touches.md)
- `PUT /v1/leads/{object_id}/external_refs/{system}`: [Set your id for a lead](https://docs.light-ai.app/api-reference/leads/put-lead-external-ref.md)
- `DELETE /v1/leads/{object_id}/external_refs/{system}`: [Remove your id for a lead](https://docs.light-ai.app/api-reference/leads/delete-lead-external-ref.md)