Skip to main content
GET
List leads

Authorizations

x-api-key
string
header
default:bd_live_your_key_here
required

Query Parameters

campaignId
string

Filter by campaign ID

linkedinUrl
string

Find the leads for one LinkedIn profile. The URL is normalized before matching, so any spelling works — http/https, with or without www., a trailing slash, or tracking parameters. Sales Navigator and private (39-character) profile URLs are matched too.

The same person can hold one lead per campaign and one per list, so this can return several leads — combine it with campaignId or campaignStatus=ACTIVE to narrow to the sequence you mean. Returns 400 if the value is not a LinkedIn profile URL.

listId
string

Filter by list ID

campaignStatus
enum<string>

Filter by status within the campaign

Available options:
CREATED,
ACTIVE,
PAUSED,
ERROR,
ARCHIVED,
COMPLETED
replied
boolean

Filter to leads that have / have not replied

unread
boolean

Filter to leads with / without an unread reply

skipped
boolean

Filter to leads that were / were not skipped

skippedReason
enum<string>

Filter by skip reason

Available options:
DUPLICATE_IN_ANOTHER_CAMPAIGN_AT_IMPORT,
DUPLICATE_IN_ANOTHER_TEAM_CAMPAIGN_AT_IMPORT
limit
number
default:25

Maximum number of leads to return (1-100)

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

Cursor from a previous response, to fetch the next page

Response

data
object[]
required
nextCursor
string | null
required

Opaque cursor for the next page; null when there are no more results. Pass it back as the cursor query parameter.