Skip to main content
GET
Get & Search Leads

Endpoint

  • Method: GET
  • Path: /api/leads
Returns leads in the active workspace, matching what you see in the Tuco UI. This is the endpoint a CRM built on Tuco uses to look up a contact (by phone, email, name, or company) and to sync the lead list.

Query Parameters

  • id (string, optional) – return a single lead by its _id (24-char ObjectId). When present, the other filters are ignored.
  • search (string, optional) – case‑insensitive match across first name, last name, email, phone, and company name. This is how you find a specific lead — pass a phone number or email to locate one contact.
  • listId (string, optional) – restrict to a specific Tuco list.
  • page (number, optional, default 1) – page number.
  • limit (number, optional, default 50, max 50) – page size.

Find a lead by phone or email

Fetch one lead by id, or page through a list


Response

No hidden changes are applied to your data by reading; this endpoint is read‑only from your point of view. Errors such as missing auth (401) or invalid query parameters (400) are returned with clear JSON messages.