Skip to main content
GET
Get lead details
Requires leads:read. Use the lead ID returned by List Campaign Leads. The lead must belong to this workspace. The endpoint accepts the full query option. See the generated response schema for supported profile, contact, outreach and custom-field data. Do not assume a provider profile ID or LinkedIn URL is the campaign lead’s ID.

Authorizations

X-API-Key
string
header
required

API key for authentication (prefix: sp_live_ or sp_test_)

Path Parameters

id
string
required

Lead ID

Query Parameters

full
boolean

true (or 1) for all fields: contact data, profile details and custom fields

Response

Lead details (use ?full=true for full data)

id
string
required

Lead ID

linkedinUrl
string
required

LinkedIn URL

status
enum<string>
required

Lead status

Available options:
PENDING,
PROCESSING,
MESSAGE_SENT,
CONNECTION_SENT,
CONNECTION_ACCEPTED,
CONNECTION_ALREADY_SENT,
REPLY_RECEIVED,
FOLLOWUP_SENT,
BLOCKED,
PROFILE_UNREACHABLE,
RATE_LIMITED,
FAILED,
SUCCESS,
UNSUBSCRIBED,
IRRELEVANT,
SKIPPED,
DONE,
MEETING_BOOKED,
OPPORTUNITY,
LIKED_POST,
MESSAGE_SCHEDULED,
CONNECTION_SCHEDULED,
LIKE_POST_SCHEDULED,
VIEW_PROFILE_SCHEDULED,
CONNECTED,
CONNECTION_WITHDRAWN,
WITHDRAWAL_SCHEDULED,
WITHDRAWAL_NOT_POSSIBLE,
NOT_CONNECTED,
ICP_MATCH,
ICP_NOT_MATCH,
PROFILE_VIEWED,
STARTED,
STOPPED,
WAITING
customLeadStatus
string
required

Custom lead status

campaignId
string
required

Campaign ID the lead belongs to

createdAt
string<date-time>
required

When the lead was added

updatedAt
string<date-time>
required

When the lead was last updated

firstName
string

First name

lastName
string

Last name

company
string

Company

title
string

Title

senderId
string | null

LinkedIn sender assigned to this lead (use as senderId for /v1/inbox/send); null until the campaign assigns one

email
string

Email address

location
string

Location

industry
string

Industry

about
string

About/bio

website
string

Website

profilePictureUrl
string

Profile picture URL

isPremium
boolean

Is premium LinkedIn account

isOpenProfile
boolean

Is open profile

connectionCount
number

Connection count

followerCount
number

Follower count

data
object

All dynamic lead data including custom fields