Prospecting
Search Contacts
Search for contacts using various filters. This is step 2 of the prospecting process.
Endpoint: (POST) https://api.lusha.com/prospecting/contact/search
Signal Filtering (Premium Feature)
Filter contacts by signal types to find prospects at key career moments.
Note: This is a premium feature. Credits are charged for each signal type that returns results.
DNC Filtering (Scale Feature)
Use excludeDnc: true at the top level of the request body to filter out contacts whose phone numbers are all marked Do Not Call.
- Contacts with at least one callable phone appear in results - Only callable phones are shown — DNC phones are hidden - Contacts with only DNC phones are excluded entirely
Note: Returns 403 on unsupported plans.
POST
/
prospecting
/
contact
/
search
curl --request POST \
--url https://api.lusha.com/prospecting/contact/search \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"pages": {
"page": 0,
"size": 20
},
"filters": {
"contacts": {
"include": {
"departments": [
"Engineering & Technical",
"Marketing"
],
"seniority": [
4,
5
],
"existing_data_points": [
"phone",
"work_email",
"mobile_phone"
],
"locations": [
{
"continent": "North America",
"country": "United States",
"city": "New York",
"state": "New York",
"country_grouping": "na"
}
],
"signals": {
"names": [
"allSignals",
"promotion",
"companyChange"
],
"startDate": "2025-11-01"
}
},
"exclude": {
"departments": [
"Human Resources"
]
}
},
"companies": {
"include": {
"names": [
"Apple",
"Microsoft"
],
"locations": [
{
"country": "United States"
}
],
"technologies": [
"Salesforce",
"Amazon Web Services"
],
"mainIndustriesIds": [
4,
5
],
"subIndustriesIds": [
101
],
"intentTopics": [
"Digital Sales"
],
"sizes": [
{
"min": 100,
"max": 1000
}
],
"revenues": [
{
"min": 10000000,
"max": 100000000
}
],
"sicCodes": [
"1011",
"1021"
],
"naicsCodes": [
"11",
"21"
]
},
"exclude": {}
}
}
}
'{
"requestId": "<string>",
"currentPage": 123,
"pageLength": 123,
"totalResults": 123,
"contacts": [
{
"contactId": "06de9b18-516d-5512-5cb5-6ec5pb215776",
"isShown": false,
"name": "Chris Karageorge",
"jobTitle": "Senior Director of Technical Operations",
"companyId": 28054532,
"companyName": "Lusha",
"fqdn": "lusha.com",
"companyDescription": "Lusha is the leader in Sales Streaming – a new sales paradigm that streams top leads straight to salespeople and handles all the outreach, so they can escape the lead grind and just sell.\\n\\nLusha’s Sales Streaming Platform is built around Sales Playlists that continuously fill up with their ideal prospects – think “Spotify for sales.” With AI doing the heavy lifting, Lusha uncovers great-fit leads salespeople never knew existed and executes tailored, perfectly timed cadences that get meetings booked. And the more you use Lusha, the smarter it gets.\\n\\nWith Sales Streaming, salespeople spend most of their time face-to-face with relevant prospects, driving 4-6X more business.",
"logoUrl": "https://logo.lusha.co/brightdata/year=2024/month=04/day=30/j_lvlvj2vh1yv1ee0hye.b098e8301e8d32c12d1c8949a0624ba44761f995.file_lvlwjpb62juzpfz0l2.logo_cached.jpg",
"hasCompanyEmployeesCount": true,
"hasCompanyRevenue": true,
"hasCompanyMainIndustry": true,
"hasCompanySubIndustry": true,
"hasCompanyFunding": true,
"hasCompanyIntent": true,
"hasCompanyTechnologies": true,
"hasDepartment": true,
"hasSeniority": true,
"hasContactLocation": true,
"hasSocialLink": true,
"hasEmails": true,
"hasWorkEmail": true,
"hasPrivateEmail": true,
"hasPhones": true,
"hasMobilePhone": true,
"hasDirectPhone": true,
"hasCompanyCity": true,
"hasCompanyCountry": true,
"signalTypes": [
"companyChange",
"promotion"
]
}
]
}{
"statusCode": 400,
"message": "Invalid request parameters"
}{
"statusCode": 401,
"message": "Invalid API key"
}{
"statusCode": 403,
"message": "Exclude DNC is not supported on your current plan. Please contact support or your account manager for assistance."
}{
"statusCode": 429,
"message": "Too many requests. Please wait before making another request."
}{
"statusCode": 500,
"message": "Internal server error. Please try again later."
}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
Show child attributes
Show child attributes
When set to true, includes contacts with partial information in the search results. Partial contacts may have incomplete data but can still be valuable prospects.
Example:
false
When true, excludes contacts whose phones are all marked Do Not Call (DNC). Contacts with at least one callable phone appear in results; only callable phones are returned (DNC phones are hidden). Contacts with only DNC phones are excluded entirely.
Example:
true
Show child attributes
Show child attributes
Response
Search results with contact IDs
Was this page helpful?
⌘I
curl --request POST \
--url https://api.lusha.com/prospecting/contact/search \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"pages": {
"page": 0,
"size": 20
},
"filters": {
"contacts": {
"include": {
"departments": [
"Engineering & Technical",
"Marketing"
],
"seniority": [
4,
5
],
"existing_data_points": [
"phone",
"work_email",
"mobile_phone"
],
"locations": [
{
"continent": "North America",
"country": "United States",
"city": "New York",
"state": "New York",
"country_grouping": "na"
}
],
"signals": {
"names": [
"allSignals",
"promotion",
"companyChange"
],
"startDate": "2025-11-01"
}
},
"exclude": {
"departments": [
"Human Resources"
]
}
},
"companies": {
"include": {
"names": [
"Apple",
"Microsoft"
],
"locations": [
{
"country": "United States"
}
],
"technologies": [
"Salesforce",
"Amazon Web Services"
],
"mainIndustriesIds": [
4,
5
],
"subIndustriesIds": [
101
],
"intentTopics": [
"Digital Sales"
],
"sizes": [
{
"min": 100,
"max": 1000
}
],
"revenues": [
{
"min": 10000000,
"max": 100000000
}
],
"sicCodes": [
"1011",
"1021"
],
"naicsCodes": [
"11",
"21"
]
},
"exclude": {}
}
}
}
'{
"requestId": "<string>",
"currentPage": 123,
"pageLength": 123,
"totalResults": 123,
"contacts": [
{
"contactId": "06de9b18-516d-5512-5cb5-6ec5pb215776",
"isShown": false,
"name": "Chris Karageorge",
"jobTitle": "Senior Director of Technical Operations",
"companyId": 28054532,
"companyName": "Lusha",
"fqdn": "lusha.com",
"companyDescription": "Lusha is the leader in Sales Streaming – a new sales paradigm that streams top leads straight to salespeople and handles all the outreach, so they can escape the lead grind and just sell.\\n\\nLusha’s Sales Streaming Platform is built around Sales Playlists that continuously fill up with their ideal prospects – think “Spotify for sales.” With AI doing the heavy lifting, Lusha uncovers great-fit leads salespeople never knew existed and executes tailored, perfectly timed cadences that get meetings booked. And the more you use Lusha, the smarter it gets.\\n\\nWith Sales Streaming, salespeople spend most of their time face-to-face with relevant prospects, driving 4-6X more business.",
"logoUrl": "https://logo.lusha.co/brightdata/year=2024/month=04/day=30/j_lvlvj2vh1yv1ee0hye.b098e8301e8d32c12d1c8949a0624ba44761f995.file_lvlwjpb62juzpfz0l2.logo_cached.jpg",
"hasCompanyEmployeesCount": true,
"hasCompanyRevenue": true,
"hasCompanyMainIndustry": true,
"hasCompanySubIndustry": true,
"hasCompanyFunding": true,
"hasCompanyIntent": true,
"hasCompanyTechnologies": true,
"hasDepartment": true,
"hasSeniority": true,
"hasContactLocation": true,
"hasSocialLink": true,
"hasEmails": true,
"hasWorkEmail": true,
"hasPrivateEmail": true,
"hasPhones": true,
"hasMobilePhone": true,
"hasDirectPhone": true,
"hasCompanyCity": true,
"hasCompanyCountry": true,
"signalTypes": [
"companyChange",
"promotion"
]
}
]
}{
"statusCode": 400,
"message": "Invalid request parameters"
}{
"statusCode": 401,
"message": "Invalid API key"
}{
"statusCode": 403,
"message": "Exclude DNC is not supported on your current plan. Please contact support or your account manager for assistance."
}{
"statusCode": 429,
"message": "Too many requests. Please wait before making another request."
}{
"statusCode": 500,
"message": "Internal server error. Please try again later."
}