DocumentationAPI ReferenceLead Management Endpoints
API Reference

Lead Management Endpoints

API endpoints for reading and updating your leads.


These endpoints give you full CRUD access to your saved businesses and their pipeline data.

GET /businesses

List all businesses. Supports pagination, filtering, and sorting.

GET /v1/businesses?stage=contacted&limit=50&page=1

GET /businesses/:id

Retrieve a single business with full details including contact history.

PATCH /businesses/:id

Update business fields or pipeline stage.

PATCH /v1/businesses/biz_abc123

{ "stage": "qualified" }

POST /businesses/:id/interactions

Add an interaction to the contact history.

POST /v1/businesses/biz_abc123/interactions

{
  "type": "call",
  "subject": "Discovery call",
  "notes": "Very interested, follow up next week",
  "date": "2026-03-06"
}