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

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

api_key

string

header

required

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

filters

object

required

Show child attributes

includePartialContact

boolean

default:true

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

excludeDnc

boolean

default: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

pages

object

Show child attributes

Response

Search results with contact IDs

requestId

string

The unique request ID used for subsequent enrichment requests

currentPage

number

The current page of the search results

pageLength

number

The number of results on the page

totalResults

number

The total number of search results

contacts

object[]

Show child attributes

⌘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."
}

Overview

Credits & Plans

Guides

Endpoints

Search Contacts

Endpoint: (POST) https://api.lusha.com/prospecting/contact/search

Signal Filtering (Premium Feature)

DNC Filtering (Scale Feature)

Authorizations

Body

Response