Prospecting
Enrich Contacts
Enrich contacts from search results. This is step 3 of the prospecting process.
Endpoint: (POST) https://api.lusha.com/prospecting/contact/enrich
⚠️ Important Notice - Unified Credits Plan Required
| Parameter | Requirement |
|---|---|
revealEmails and revealPhones | Only available to customers on the Unified Credits pricing plan |
| Plan Restriction | Attempting to use these parameters on other plans will result in a 403 Unauthorized error |
| Default Behavior | When neither parameter is used, the API returns both email addresses and phone numbers, if available |
POST
/
prospecting
/
contact
/
enrich
curl --request POST \
--url https://api.lusha.com/prospecting/contact/enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"requestId": "b6effae6-35b8-493d-91aa-7d3b1b7c7dc7",
"contactIds": [
"37b4c536-eaec-11ef-ad4b-a75f8e9e1484"
]
}
'
{
"requestId": "<string>",
"contacts": [
{
"id": "<string>",
"isSuccess": true,
"data": {
"firstName": "Carolina",
"lastName": "Portela",
"fullName": "Carolina Portela",
"isShown": false,
"jobTitle": "Solutions Engineer",
"location": {
"city": "Boston",
"state": "Massachusetts",
"country": "United States",
"country_iso2": "US",
"continent": "North America"
},
"emailAddresses": [
{
"email": "dustin@lusha.com",
"address": "dustin@lusha.com",
"emailType": "work",
"emailConfidence": "A+",
"updateDate": "2020-01-01"
}
],
"phoneNumbers": [
{
"phoneType": "Mobile",
"doNotCall": false,
"updateDate": "2020-01-01",
"number": "+1234567890"
}
],
"companyId": 3553744,
"companyName": "Lusha",
"socialLinks": {
"linkedin": "https://www.linkedin.com/in/carolinaportela/",
"xUrl": "https://twitter.com/carolina"
},
"departments": [
"Engineering & Technical"
],
"seniority": [
{
"id": 4,
"value": "senior"
}
],
"company": {
"revenueRange": [
123
],
"funding": {
"totalRounds": 2,
"currency": "USD",
"isIpo": false,
"rounds": [
{
"currency": "USD",
"roundAmount": 205000000,
"roundType": "Private Equity Round",
"roundDate": "Nov 10, 2021"
}
],
"totalRoundsAmount": 245000000,
"lastRoundType": "Private Equity Round",
"lastRoundAmount": 205000000,
"lastRoundDate": "Nov 10, 2021"
},
"intent": {
"detectedTopics": [
{
"topicName": "Remote Sales",
"metadata": {
"topicScore": 83,
"topicTrend": "-5"
}
}
],
"topicCount": 6
},
"mainIndustry": "<string>",
"subIndustry": "<string>",
"technologies": [
{
"name": "salesforce"
}
]
},
"linkedinFollowersCount": 1250,
"linkedinConnectionsCount": 500,
"linkedinCertifications": [
{
"companyId": 1035,
"companyName": "Microsoft",
"credentialId": "abc123",
"dateMonth": 6,
"dateYear": 2020,
"expireDateMonth": 6,
"expireDateYear": 2025,
"linkedinCompanyId": 1441,
"summary": "Azure fundamentals certification covering cloud concepts",
"title": "Microsoft Certified: Azure Fundamentals",
"verifyUrl": "https://www.youracclaim.com/badges/5ccf865c-dd6e-4dcc-9184-c8999d31f83d"
}
],
"linkedinCourses": [
{
"activities": "<string>",
"degree": "<string>",
"endDate": "<string>",
"endDateMonth": 123,
"endDateYear": 123,
"fieldOfStudy": {
"id": "<string>",
"name": "<string>"
},
"grade": "<string>",
"incompleteEducation": true,
"notes": "<string>",
"school": {
"createdAt": "<string>",
"id": "<string>",
"logoUrl": "<string>",
"name": "<string>",
"updatedAt": "<string>"
},
"startDate": "<string>",
"startDateMonth": 123,
"startDateYear": 123,
"linkedinSchoolId": 123
}
],
"linkedinAwards": [
{
"companyName": "Columbia Southern University",
"dateDay": 15,
"dateMonth": 7,
"dateYear": 2023,
"linkedinCompanyId": "<string>",
"summary": "Certificate of Recognition for Exceptional Teaching",
"title": "Raising the Bar Award"
}
],
"linkedinSkills": [
"Microsoft Office",
"Project Management",
"Strategic Planning"
]
}
}
]
}
Authorizations
Your Lusha API key. You can find this in your Lusha dashboard under API settings.
Include this key in the api_key header for all requests.
Body
application/json
The requestId generated in the Prospecting Search response (UUID)
Example:
"b6effae6-35b8-493d-91aa-7d3b1b7c7dc7"
An array containing the contact IDs for enrichment. Min 1, max 100.
Example:
["37b4c536-eaec-11ef-ad4b-a75f8e9e1484"]
Set revealEmails=true to retrieve only the email address of the contact.
Only available to customers on the Unified Credits pricing plan.
Example:
false
Set revealPhones=true to retrieve only the phone number of the contact.
Only available to customers on the Unified Credits pricing plan.
Example:
true
Was this page helpful?
⌘I
curl --request POST \
--url https://api.lusha.com/prospecting/contact/enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"requestId": "b6effae6-35b8-493d-91aa-7d3b1b7c7dc7",
"contactIds": [
"37b4c536-eaec-11ef-ad4b-a75f8e9e1484"
]
}
'
{
"requestId": "<string>",
"contacts": [
{
"id": "<string>",
"isSuccess": true,
"data": {
"firstName": "Carolina",
"lastName": "Portela",
"fullName": "Carolina Portela",
"isShown": false,
"jobTitle": "Solutions Engineer",
"location": {
"city": "Boston",
"state": "Massachusetts",
"country": "United States",
"country_iso2": "US",
"continent": "North America"
},
"emailAddresses": [
{
"email": "dustin@lusha.com",
"address": "dustin@lusha.com",
"emailType": "work",
"emailConfidence": "A+",
"updateDate": "2020-01-01"
}
],
"phoneNumbers": [
{
"phoneType": "Mobile",
"doNotCall": false,
"updateDate": "2020-01-01",
"number": "+1234567890"
}
],
"companyId": 3553744,
"companyName": "Lusha",
"socialLinks": {
"linkedin": "https://www.linkedin.com/in/carolinaportela/",
"xUrl": "https://twitter.com/carolina"
},
"departments": [
"Engineering & Technical"
],
"seniority": [
{
"id": 4,
"value": "senior"
}
],
"company": {
"revenueRange": [
123
],
"funding": {
"totalRounds": 2,
"currency": "USD",
"isIpo": false,
"rounds": [
{
"currency": "USD",
"roundAmount": 205000000,
"roundType": "Private Equity Round",
"roundDate": "Nov 10, 2021"
}
],
"totalRoundsAmount": 245000000,
"lastRoundType": "Private Equity Round",
"lastRoundAmount": 205000000,
"lastRoundDate": "Nov 10, 2021"
},
"intent": {
"detectedTopics": [
{
"topicName": "Remote Sales",
"metadata": {
"topicScore": 83,
"topicTrend": "-5"
}
}
],
"topicCount": 6
},
"mainIndustry": "<string>",
"subIndustry": "<string>",
"technologies": [
{
"name": "salesforce"
}
]
},
"linkedinFollowersCount": 1250,
"linkedinConnectionsCount": 500,
"linkedinCertifications": [
{
"companyId": 1035,
"companyName": "Microsoft",
"credentialId": "abc123",
"dateMonth": 6,
"dateYear": 2020,
"expireDateMonth": 6,
"expireDateYear": 2025,
"linkedinCompanyId": 1441,
"summary": "Azure fundamentals certification covering cloud concepts",
"title": "Microsoft Certified: Azure Fundamentals",
"verifyUrl": "https://www.youracclaim.com/badges/5ccf865c-dd6e-4dcc-9184-c8999d31f83d"
}
],
"linkedinCourses": [
{
"activities": "<string>",
"degree": "<string>",
"endDate": "<string>",
"endDateMonth": 123,
"endDateYear": 123,
"fieldOfStudy": {
"id": "<string>",
"name": "<string>"
},
"grade": "<string>",
"incompleteEducation": true,
"notes": "<string>",
"school": {
"createdAt": "<string>",
"id": "<string>",
"logoUrl": "<string>",
"name": "<string>",
"updatedAt": "<string>"
},
"startDate": "<string>",
"startDateMonth": 123,
"startDateYear": 123,
"linkedinSchoolId": 123
}
],
"linkedinAwards": [
{
"companyName": "Columbia Southern University",
"dateDay": 15,
"dateMonth": 7,
"dateYear": 2023,
"linkedinCompanyId": "<string>",
"summary": "Certificate of Recognition for Exceptional Teaching",
"title": "Raising the Bar Award"
}
],
"linkedinSkills": [
"Microsoft Office",
"Project Management",
"Strategic Planning"
]
}
}
]
}