curl --request POST \
--url https://api.generect.com/api/v1/enrich/database/lead/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9"
}
'{
"data": {
"id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9",
"sales_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9",
"linkedin_id": "78461298",
"linkedin_url": "https://www.linkedin.com/in/jordan-ellis",
"linkedin_sales_link": "https://www.linkedin.com/sales/lead/ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9,NAME_SEARCH,x7Kq",
"first_name": "Jordan",
"middle_name": "",
"last_name": "Ellis",
"full_name": "Jordan Ellis",
"unformatted_full_name": "Jordan Ellis",
"translated_first_name": null,
"headline": "CEO at Microsoft",
"summary": "Building the platforms other companies build on.",
"gender": "male",
"nationality": "American",
"industry": "Software Development",
"location": "Redmond, Washington, United States",
"location_city": "Redmond",
"location_state": "Washington",
"location_county": "King County",
"location_country": "United States",
"num_of_connections": 500,
"profile_photo": "https://media.licdn.com/dms/image/v2/C5603AQExample/profile-displayphoto-shrink_800_800/0/1",
"twitter_link": null,
"private_website": null,
"contact_info": {
"websites": [
{
"url": "https://jordanellis.example.com",
"category": "PERSONAL",
"dataSource": "LINKEDIN"
}
]
},
"is_premium": true,
"is_openlink": false,
"is_job_seeker": false,
"is_retired": false,
"is_full_data": true,
"has_current_position": true,
"job_title": "Chief Executive Officer",
"raw_job_title": "CEO",
"job_started_on": "Feb 2014",
"job_ended_on": null,
"job_location": "Redmond, Washington, United States",
"job_location_city": "Redmond",
"job_location_state": "Washington",
"job_location_county": "King County",
"job_location_country": "United States",
"company_id": "1035",
"company_name": "Microsoft",
"company_url": "https://www.linkedin.com/company/microsoft",
"company_website": "https://www.microsoft.com",
"company_industry": "Software Development",
"company_location": "Redmond, Washington, United States",
"company_description": "Every company has a mission. What's ours? To empower every person and every organization to achieve more.",
"company_image": "https://media.licdn.com/dms/image/v2/C560BAQExample/company-logo_200_200/0/1",
"jobs": [
{
"job_title": "Chief Executive Officer",
"raw_job_title": "CEO",
"job_description": null,
"job_started_on": "Feb 2014",
"job_ended_on": null,
"job_still_working": true,
"job_location": "Redmond, Washington, United States",
"job_location_city": "Redmond",
"job_location_state": "Washington",
"job_location_county": "King County",
"job_location_country": "United States",
"company_id": "1035",
"company_name": "Microsoft",
"raw_company_name": "Microsoft",
"company_url": "https://www.linkedin.com/company/microsoft",
"company_website": "https://www.microsoft.com",
"company_industry": "Software Development",
"company_headcount_range": "10001+",
"company_location": "Redmond, Washington, United States",
"company_city": "Redmond",
"company_state": "Washington",
"company_country": "United States",
"company_image": "https://media.licdn.com/dms/image/v2/C560BAQExample/company-logo_200_200/0/1",
"company_description": "Every company has a mission. What's ours? To empower every person and every organization to achieve more."
}
],
"educations": [
{
"university_id": "1792",
"university_name": "Stanford University",
"university_url": "https://www.linkedin.com/school/stanford-university",
"university_logo": "https://media.licdn.com/dms/image/v2/C4E0BAQExample/company-logo_200_200/0/1",
"university_description": null,
"degree": "Master of Science (MS)",
"fields_of_study": [
"Computer Science"
],
"started_on": {
"year": 2004
},
"ended_on": {
"year": 2006
}
}
],
"certifications": [],
"languages": [
{
"name": "English",
"proficiency": "NATIVE_OR_BILINGUAL"
}
],
"volunteering": [],
"patents": [],
"publications": [],
"skills": [
"Cloud Computing",
"Software Development",
"Leadership"
],
"source": "lead_by_link"
},
"meta": {
"amount_charged": 0.02
}
}{
"status": "error",
"status_code": 400,
"detail": {
"fields": "exactly one of id, linkedin_url, email is required"
}
}{
"status": "error",
"status_code": 401,
"detail": "Authentication credentials were not provided."
}{
"status": "error",
"status_code": 402,
"detail": "Insufficient funds in the account."
}{
"status": "error",
"status_code": 403,
"detail": "You do not have permission to perform this action."
}{
"status": "error",
"status_code": 429,
"detail": "Request was throttled."
}Leads
Enrich lead from database
Retrieve a full lead profile from cached data. Provide exactly one identifier.
POST
/
api
/
v1
/
enrich
/
database
/
lead
/
curl --request POST \
--url https://api.generect.com/api/v1/enrich/database/lead/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9"
}
'{
"data": {
"id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9",
"sales_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9",
"linkedin_id": "78461298",
"linkedin_url": "https://www.linkedin.com/in/jordan-ellis",
"linkedin_sales_link": "https://www.linkedin.com/sales/lead/ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9,NAME_SEARCH,x7Kq",
"first_name": "Jordan",
"middle_name": "",
"last_name": "Ellis",
"full_name": "Jordan Ellis",
"unformatted_full_name": "Jordan Ellis",
"translated_first_name": null,
"headline": "CEO at Microsoft",
"summary": "Building the platforms other companies build on.",
"gender": "male",
"nationality": "American",
"industry": "Software Development",
"location": "Redmond, Washington, United States",
"location_city": "Redmond",
"location_state": "Washington",
"location_county": "King County",
"location_country": "United States",
"num_of_connections": 500,
"profile_photo": "https://media.licdn.com/dms/image/v2/C5603AQExample/profile-displayphoto-shrink_800_800/0/1",
"twitter_link": null,
"private_website": null,
"contact_info": {
"websites": [
{
"url": "https://jordanellis.example.com",
"category": "PERSONAL",
"dataSource": "LINKEDIN"
}
]
},
"is_premium": true,
"is_openlink": false,
"is_job_seeker": false,
"is_retired": false,
"is_full_data": true,
"has_current_position": true,
"job_title": "Chief Executive Officer",
"raw_job_title": "CEO",
"job_started_on": "Feb 2014",
"job_ended_on": null,
"job_location": "Redmond, Washington, United States",
"job_location_city": "Redmond",
"job_location_state": "Washington",
"job_location_county": "King County",
"job_location_country": "United States",
"company_id": "1035",
"company_name": "Microsoft",
"company_url": "https://www.linkedin.com/company/microsoft",
"company_website": "https://www.microsoft.com",
"company_industry": "Software Development",
"company_location": "Redmond, Washington, United States",
"company_description": "Every company has a mission. What's ours? To empower every person and every organization to achieve more.",
"company_image": "https://media.licdn.com/dms/image/v2/C560BAQExample/company-logo_200_200/0/1",
"jobs": [
{
"job_title": "Chief Executive Officer",
"raw_job_title": "CEO",
"job_description": null,
"job_started_on": "Feb 2014",
"job_ended_on": null,
"job_still_working": true,
"job_location": "Redmond, Washington, United States",
"job_location_city": "Redmond",
"job_location_state": "Washington",
"job_location_county": "King County",
"job_location_country": "United States",
"company_id": "1035",
"company_name": "Microsoft",
"raw_company_name": "Microsoft",
"company_url": "https://www.linkedin.com/company/microsoft",
"company_website": "https://www.microsoft.com",
"company_industry": "Software Development",
"company_headcount_range": "10001+",
"company_location": "Redmond, Washington, United States",
"company_city": "Redmond",
"company_state": "Washington",
"company_country": "United States",
"company_image": "https://media.licdn.com/dms/image/v2/C560BAQExample/company-logo_200_200/0/1",
"company_description": "Every company has a mission. What's ours? To empower every person and every organization to achieve more."
}
],
"educations": [
{
"university_id": "1792",
"university_name": "Stanford University",
"university_url": "https://www.linkedin.com/school/stanford-university",
"university_logo": "https://media.licdn.com/dms/image/v2/C4E0BAQExample/company-logo_200_200/0/1",
"university_description": null,
"degree": "Master of Science (MS)",
"fields_of_study": [
"Computer Science"
],
"started_on": {
"year": 2004
},
"ended_on": {
"year": 2006
}
}
],
"certifications": [],
"languages": [
{
"name": "English",
"proficiency": "NATIVE_OR_BILINGUAL"
}
],
"volunteering": [],
"patents": [],
"publications": [],
"skills": [
"Cloud Computing",
"Software Development",
"Leadership"
],
"source": "lead_by_link"
},
"meta": {
"amount_charged": 0.02
}
}{
"status": "error",
"status_code": 400,
"detail": {
"fields": "exactly one of id, linkedin_url, email is required"
}
}{
"status": "error",
"status_code": 401,
"detail": "Authentication credentials were not provided."
}{
"status": "error",
"status_code": 402,
"detail": "Insufficient funds in the account."
}{
"status": "error",
"status_code": 403,
"detail": "You do not have permission to perform this action."
}{
"status": "error",
"status_code": 429,
"detail": "Request was throttled."
}Use Case:
Retrieve a full lead profile from cached data by Generect ID, LinkedIn URL, or email (reverse lookup).Optional sections
The same activity flags as Real-time apply here:posts, comments, reactions and people_also_viewed each add +1 credit when the section comes back with data, while get_full_experience and inexact_company are free.
Pricing
This is a billable endpoint — you are charged only when a lead is found and returned. If nothing is found, the request is free.Your price decreases automatically as your lifetime spend grows. Check your current tier and pricing →
Authorizations
Body
application/json
- By Generect ID
- By LinkedIn URL
- By Email
Response
Full lead profile. If no data is found, the request is free.
A lead profile. Every field below comes back from both the realtime and the database lead enrich. A field the profile does not have comes back null or as an empty list. Database and email lookups add derived fields on top, such as seniority, schools, past_companies, past_job_titles, position_since and company_since, and a realtime lookup by URL adds input_url and raw_headline. Treat any field not listed here as optional.
Show child attributes
Show child attributes
Was this page helpful?