Sign in
Leads

Search the leads in a workspace.

Free-text search across name, email, and company, narrowed by campaign, audience, or how the lead has engaged with its page.

get/api/external/v1/leads/search

Query parameters

workspace_idinteger required

The workspace to search.

Example:55

The workspace to search.

searchstring nullable

Matches name, email, or company.

Example:acme

Matches name, email, or company.

campaign_idsinteger[]

Only leads on these campaigns.

Only leads on these campaigns.

[
  1,
  2
]
audience_idsinteger[]

Only leads in these audiences.

Only leads in these audiences.

[
  3
]
engagementstring[]

Filter by engagement: all, page_viewed, button_clicked, scroll_100_percent, form_submitted.

Filter by engagement: all, page_viewed, button_clicked, scroll_100_percent, form_submitted.

[
  "form_submitted"
]
limitinteger nullable

How many to return, 1-100. Defaults to 25.

Example:25

How many to return, 1-100. Defaults to 25.

Response

totalinteger
returnedinteger

Example response

{
  "total": 340,
  "returned": 25,
  "leads": [
    {
      "lead_id": 56789,
      "name": "John Doe",
      "email": "john@aws.com",
      "company_name": "AWS",
      "company_domain": "aws.com",
      "genpage_url": "https://myworkspace.genpa.ge/aws-john",
      "created_at": "2026-08-16T10:00:00.000000Z"
    }
  ]
}

Changes