Skip to main content
GET
List leads

Authorizations

Authorization
string
header
required

A ManyPI API key (mpi_...) from Settings → API keys, or an OAuth 2.1 access token obtained through the MCP consent flow.

Query Parameters

q
string

Free text across company, full name, email and domain.

status
enum<string>

A lead status, or archived / unsubscribed (which are flags, not statuses).

Available options:
new,
qualified,
contacted,
disqualified,
archived,
unsubscribed
campaign
string<uuid>

The agent run id of the lead search that produced the leads.

brand
string

Narrow to one brand, or all for the whole workspace.

limit
integer
default:100

Max 500.

Required range: x <= 500
offset
integer
default:0

Response

Leads and grid metadata.

leads
object[]
total
integer

Rows matching the current filter.

workspaceTotal
integer

Every lead the workspace stores, ignoring filters.

customColumns
string[]
customFields
object[]
campaigns
object[]

Past lead searches, with how many leads each produced.

leadLimit
integer

Stored-lead cap for the plan.