Skip to main content
GET
Get Leads Endpoint

Endpoint

  • Method: GET
  • Path: /api/leads
This endpoint returns leads in the active workspace, matching what you see in the Tuco UI.

Query Parameters

  • listId (string, optional) – restrict to a specific Tuco list.
  • search (string, optional) – case‑insensitive search on name, email, phone, or company.
  • page (number, optional, default 1) – page number.
  • limit (number, optional, default 50) – page size.
Example:

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.