Skip to main content
GET
List active leads available to this key.

Authorizations

Authorization
string
header
required

API key created from Integrations > API. Used for Customer REST and Ordinal Audience Analytics.

Query Parameters

limit
integer
default:50

Number of items to return. The default is 50 and the maximum is 100.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor returned in page.nextCursor. Pass it unchanged with the same filters and sort. Incompatible cursors return validation_failed.

Maximum string length: 256
tier
enum<string>
Available options:
UNQUALIFIED,
NURTURE,
QUALIFIED,
PRIORITY
leadTiers
string

Comma-separated lead tiers. Accepts up to four values.

disposition
enum<string>
Available options:
ACTIVE,
CLIENT,
BAD_LEAD
dispositions
string

Comma-separated dispositions. Accepts up to three values. Omitted dispositions default to ACTIVE.

minIcpMatchPercent
integer
Required range: 0 <= x <= 100
maxIcpMatchPercent
integer
Required range: 0 <= x <= 100
monitoredProfileId
string<uuid>
monitoredProfileIds
string

Comma-separated monitored profile IDs. Accepts up to 50 IDs.

postId
string<uuid>
engagementType
enum<string>
Available options:
LIKE,
COMMENT,
REPOST
engagementTypes
string

Comma-separated engagement types. Accepts up to three values.

ownerId
string<uuid>
ownerIds
string

Comma-separated owner IDs. Accepts up to 50 IDs.

dateFrom
string<date-time>

Inclusive start of the date range.

dateTo
string<date-time>

Inclusive end of the date range.

query
string
Required string length: 1 - 160
companyNames
string

Comma-separated company names. Accepts up to 25 values.

origin
enum<string>
default:all

Safe lead origin. agent includes automated Agent and preview discovery; watchlist includes watched-profile and manual workflows.

Available options:
agent,
watchlist,
all

Response

Lead page. Contact fields are null unless the key has leads:contact_read.

data
object[]
required
page
object
required