Skip to main content
GET
Get Lead
Reads one lead by id. The lookup is scoped to your workspace, so an id from another workspace returns 404 rather than leaking anything.
Don’t have the id? GET /api/leads?search=… finds a lead by phone, email, name or company. Search by phone in E.164 and URL-encode the + as %2B.

Authentication

Pass your workspace API key as a Bearer token, or use a Clerk session token.

Path parameter

string
required
The lead id — leadId from POST /api/leads, or _id from GET /api/leads. A malformed id returns 400 Invalid lead id.

Example

Success (200 OK)

Response

object
The lead. Only these fields are returned — enrolment state and internal bookkeeping are not exposed.

Errors