Skip to main content
POST
Enrich a single lead account

Authorizations

X-API-KEY
string
header
required

Your API key

Body

application/json
first_name
string
required

First name

Example:

"Mathieu"

last_name
string
required

Last name

Example:

"Brun-Picard"

company_name
string
required

Company name

Example:

"Pipecorn"

linkedin_url
string<uri>

LinkedIn profile URL

Example:

"https://www.linkedin.com/in/mathieu-brun-picard/"

live
boolean
default:true

Data source toggle. true (default) resolves the person live from LinkedIn and returns the fully enriched profile. false resolves the person from Pipecorn's people database (Elasticsearch) instead: no LinkedIn call is made and no LinkedIn integration is required, but email and phone are not included and the response is the lighter Pipecorn-formatted profile (first_name, last_name, full_name, linkedin_url, headline, current_title, company_name, location, profile_image_url). A non-boolean value returns 422.

Example:

true

Response

Successfully enriched lead

status
string

Qualification status of the lead

Example:

"QUALIFIED"

rejection_reason
string | null

Reason for rejection if the lead was not qualified

first_name
string

First name of the lead

last_name
string

Last name of the lead

gender
string | null

Gender of the lead if available

most_probable_email
string | null

Most likely email address for the lead

most_probable_email_status
string | null

Status of the most probable email verification

phones
string[]

List of phone numbers associated with the lead

title
string

Current job title

linkedin_profile_url
string<uri>

URL to the lead's LinkedIn profile

linkedin_id_url
string<uri>

LinkedIn ID URL of the lead

regular_urn
string

LinkedIn regular URN identifier

lk_headline
string

LinkedIn headline

lk_connections_count
integer

Number of LinkedIn connections

years_in_position
integer | null

Number of years in current position

months_in_position
integer | null

Number of months in current position

years_in_company
integer | null

Number of years in current company

months_in_company
integer | null

Number of months in current company

current_position
object
positions
object[]

List of all positions held by the lead

title_description
string

Description of the current title/role

summary
string | null

Profile summary

full_name
string

Full name of the lead

sales_navigator_profile_url
string<uri> | null

URL to the lead's Sales Navigator profile

profile_image_url
string<uri>

URL to the lead's profile image

connection_degree
integer

LinkedIn connection degree (1st, 2nd, 3rd)

is_premium_linkedin
boolean | null

Whether the lead has LinkedIn Premium

is_open_profile_linkedin
boolean | null

Whether the lead has an open LinkedIn profile

is_open_to_work_linkedin
boolean | null

Whether the lead is open to work on LinkedIn

past_position
object

Most recent past position