Leads & Clients API

Retrieve a paginated list of leads.

**Query Parameters:**

• •**page** (number) — Page number (default: 1)
• •**limit** (number) — Items per page (default: 20, max: 100)
• •**status** (string) — Filter by status (new, contacted, qualified, won, lost)
• •**search** (string) — Search by name, email, or company
• •**sort** (string) — Sort field (createdAt, updatedAt, score)
• •**order** (string) — Sort order (asc, desc)

**Response (200 OK):**

• •data — Array of lead objects
• •pagination — Page info including total, page, limit

Create a new lead.

**Request Body:**

• •**name** (string, required) — Contact name
• •**email** (string, required) — Contact email
• •**phone** (string) — Contact phone number
• •**company** (string) — Company name
• •**source** (string) — Lead source (website, referral, social, etc.)
• •**notes** (string) — Additional notes

**Response (201 Created):**

• •Returns the created lead object with generated ID

Update an existing lead.

**Path Parameters:**

• •**id** (string, required) — Lead ID

**Request Body:** Any lead fields to update

**Response (200 OK):**

• •Returns the updated lead object

**Error Responses:**

• •404 — Lead not found
• •400 — Validation errors

Client management follows the same pattern:

• •GET /clients — List clients with pagination and filtering
• •POST /clients — Create a new client
• •GET /clients/:id — Get client details
• •PUT /clients/:id — Update client information
• •DELETE /clients/:id — Archive a client record

Clients can be created from converted leads using POST /leads/:id/convert.