# Prospecting - Search & Enrich

With Lusha's Prospecting API, you can query Lusha's extensive database based on specific criteria (such as job title, seniority, location, and more) to retrieve detailed contact and company information.

The Prospecting API is designed to help you generate new records (contacts or companies) for your CRM system, using filters that align with your Ideal Customer Profile (ICP).

This process involves three main steps:

| Step | API | Description |
|------|-----|-------------|
| 1 | **Filters API** | Apply filters to refine your search *(check available Contact and Company filter endpoints)* |
| 2 | **Search API** | Query Contacts or Companies using the available filters |
| 3 | **Enrich API** | Get full details of Contacts and Companies from the search results |


## Search Contacts

 - [POST /prospecting/contact/search](https://docs.lusha.com/apis/v2/openapi/prospecting-search-and-enrich/searchprospectingcontacts.md): 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.

## Enrich Contacts

 - [POST /prospecting/contact/enrich](https://docs.lusha.com/apis/v2/openapi/prospecting-search-and-enrich/enrichprospectingcontacts.md): 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 |

---

## Search Companies

 - [POST /prospecting/company/search](https://docs.lusha.com/apis/v2/openapi/prospecting-search-and-enrich/searchprospectingcompanies.md): Search for companies using various filters. This is step 2 of the prospecting process.

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

##### Signal Filtering (Premium Feature)
Filter companies by signal types to identify those with recent business events and changes.

  > Note: This is a premium feature. Credits are charged for each signal type that returns results.

## Enrich Companies

 - [POST /prospecting/company/enrich](https://docs.lusha.com/apis/v2/openapi/prospecting-search-and-enrich/enrichprospectingcompanies.md): Enrich companies from search results. This is step 3 of the prospecting process.

 Endpoint: (POST)  https://api.lusha.com/prospecting/company/enrich