# Enrich Contacts

Enrich contacts from search results. This is step 3 of the prospecting process.
        
---

⚠️ 

| Parameter | Requirement |
|-----------|-------------|
|  and  | Only available to customers on the  pricing plan |
| Plan Restriction | Attempting to use these parameters on other plans will result in a  error |
| Default Behavior | When neither parameter is used, the API returns , if available |

---


Endpoint: POST /prospecting/contact/enrich
Security: ApiKeyAuth

## Request fields (application/json):

  - `requestId` (string, required)
    The requestId generated in the Prospecting Search response (UUID)
    Example: "b6effae6-35b8-493d-91aa-7d3b1b7c7dc7"

  - `contactIds` (array, required)
    An array containing the contact IDs for enrichment. Min 1, max 100.
    Example: ["37b4c536-eaec-11ef-ad4b-a75f8e9e1484"]

  - `revealEmails` (boolean)
    Set  to retrieve only the email address of the contact.
Only available to customers on the  pricing plan.

  - `revealPhones` (boolean)
    Set  to retrieve only the phone number of the contact.
Only available to customers on the  pricing plan.
    Example: true

## Response 200 fields (application/json):

  - `requestId` (string)
    The requestId that was used in the request

  - `contacts` (array)

  - `contacts.id` (string)
    The ID of the contact from the enrichment request

  - `contacts.isSuccess` (boolean)
    Indicates whether the enrichment process was successful

  - `contacts.data` (object)

  - `contacts.data.firstName` (string)

  - `contacts.data.lastName` (string)

  - `contacts.data.fullName` (string)

  - `contacts.data.isShown` (boolean)

  - `contacts.data.jobTitle` (string)

  - `contacts.data.location` (object)

  - `contacts.data.location.city` (string)

  - `contacts.data.location.state` (string)

  - `contacts.data.location.country` (string)

  - `contacts.data.location.country_iso2` (string)

  - `contacts.data.location.continent` (string)

  - `contacts.data.emailAddresses` (array)

  - `contacts.data.emailAddresses.address` (string)
    The email address
    Example: "dustin@lusha.com"

  - `contacts.data.emailAddresses.type` (string)
    The type of email address
    Example: "work"

  - `contacts.data.emailAddresses.emailConfidence` (string)
    The confidence level of the email address
    Example: "A+"

  - `contacts.data.emailAddresses.updateDate` (string)
    The update date of the email address
    Example: "2020-01-01"

  - `contacts.data.phoneNumbers` (array)

  - `contacts.data.phoneNumbers.number` (string)
    The phone number
    Example: "+1234567890"

  - `contacts.data.phoneNumbers.phoneType` (string, required)
    The type of phone number
    Enum: "Mobile", "Direct", "Phone"

  - `contacts.data.phoneNumbers.doNotCall` (boolean, required)
    Indicates whether the phone number is listed as "Do Not Call" (DNC).

  - `contacts.data.phoneNumbers.updateDate` (string, required)
    The update date of the phone number
    Example: "2020-01-01"

  - `contacts.data.companyId` (number)

  - `contacts.data.companyName` (string)

  - `contacts.data.socialLinks` (object)

  - `contacts.data.socialLinks.linkedin` (string)

  - `contacts.data.departments` (array)

  - `contacts.data.seniority` (array)

  - `contacts.data.seniority.id` (number)

  - `contacts.data.seniority.value` (string)

  - `contacts.data.company` (object)

  - `contacts.data.company.revenueRange` (array)

  - `contacts.data.company.funding` (object)

  - `contacts.data.company.funding.rounds` (array)
    List of funding rounds

  - `contacts.data.company.funding.rounds.currency` (string, required)
    Currency of the funding round
    Example: "USD"

  - `contacts.data.company.funding.rounds.roundAmount` (number, required)
    Amount raised in the round
    Example: 205000000

  - `contacts.data.company.funding.rounds.roundType` (string, required)
    Type of funding round
    Example: "Private Equity Round"

  - `contacts.data.company.funding.rounds.roundDate` (string, required)
    Date of the funding round
    Example: "Nov 10, 2021"

  - `contacts.data.company.funding.totalRounds` (number, required)
    Total number of rounds
    Example: 2

  - `contacts.data.company.funding.totalRoundsAmount` (number)
    Total amount raised across all rounds
    Example: 245000000

  - `contacts.data.company.funding.currency` (string, required)
    Currency used
    Example: "USD"

  - `contacts.data.company.funding.isIpo` (boolean, required)
    Whether the company has gone public

  - `contacts.data.company.funding.lastRoundType` (string)
    Type of the last funding round
    Example: "Private Equity Round"

  - `contacts.data.company.funding.lastRoundAmount` (number)
    Amount of the last funding round
    Example: 205000000

  - `contacts.data.company.funding.lastRoundDate` (string)
    Date of the last funding round
    Example: "Nov 10, 2021"

  - `contacts.data.company.intent` (object)

  - `contacts.data.company.intent.detectedTopics` (array, required)
    Detected intent topics

  - `contacts.data.company.intent.detectedTopics.topicName` (string, required)
    Name of the intent topic
    Example: "Remote Sales"

  - `contacts.data.company.intent.detectedTopics.metadata` (object, required)

  - `contacts.data.company.intent.detectedTopics.metadata.topicScore` (number, required)
    Relevance score for the intent topic
    Example: 83

  - `contacts.data.company.intent.detectedTopics.metadata.topicTrend` (string, required)
    Trend of the topic (e.g., +1, -5, New)
    Example: "-5"

  - `contacts.data.company.intent.topicCount` (number, required)
    Number of topics detected
    Example: 6

  - `contacts.data.company.mainIndustry` (string)

  - `contacts.data.company.subIndustry` (string)

  - `contacts.data.company.technologies` (array)

  - `contacts.data.company.technologies.name` (string, required)
    Technology name used by the company
    Example: "salesforce"

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 401 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 403 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 429 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 500 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message