POST /prospecting/contact/enrich - Enrich contacts

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": "b6effae6-35b8-493d-91aa-7d3b1b7c7dc7",
  "contacts": [
    {
      "id": "37b4c536-eaec-11ef-ad4b-a75f8e9e1484",
      "isSuccess": true,
      "data": {
        "firstName": "Carolina",
        "lastName": "Portela",
        "fullName": "Carolina Portela",
        "jobTitle": "Solutions Engineer",
        "departments": ["Engineering & Technical"],
        "seniority": [{ "id": 4, "value": "senior" }],
        "location": {
          "city": "Boston",
          "state": "Massachusetts",
          "country": "United States",
          "country_iso2": "US",
          "continent": "North America"
        },
        "emailAddresses": [
          {
            "email": "carolina@lusha.com",
            "emailType": "work",
            "emailConfidence": "A+",
            "updateDate": "2024-03-01"
          }
        ],
        "phoneNumbers": [
          {
            "number": "+16175551234",
            "phoneType": "Mobile",
            "doNotCall": false,
            "updateDate": "2024-03-01"
          }
        ],
        "socialLinks": {
          "linkedin": "https://www.linkedin.com/in/carolinaportela/"
        },
        "companyId": 3553744,
        "companyName": "Lusha"
      }
    }
  ]
}

{
  "statusCode": 403,
  "message": "Forbidden",
  "errors": ["revealEmails is only available on the Unified Credits plan"]
}

After searching for contacts with POST /prospecting/contact/search, use this endpoint to retrieve complete contact profiles - including email addresses, phone numbers, location, seniority, and company details - for up to 100 contacts per request. This is step 3 of the three-step prospecting flow.

Unified Credits plan required for selective revealThe revealEmails and revealPhones parameters are only available on the Unified Credits pricing plan. Using either parameter on other plans returns a 403 error.When you omit both parameters, the API returns all available contact details (emails and phones) by default.

Endpoint

POST https://api.lusha.com/prospecting/contact/enrich

Authentication: API key (ApiKeyAuth)

Request body

string

required

The requestId returned by the Search Contacts response for the same session. Example: "b6effae6-35b8-493d-91aa-7d3b1b7c7dc7"

string[]

required

Array of contactId values from the search results you want to enrich. Minimum 1, maximum 100. Example: ["37b4c536-eaec-11ef-ad4b-a75f8e9e1484"]

boolean

Unified Credits plan only. When true, the response includes email addresses only (phone numbers are excluded). Omit this field to receive all available data types.

boolean

Unified Credits plan only. When true, the response includes phone numbers only (emails are excluded). Omit this field to receive all available data types.

Example request

curl --request POST \
  --url https://api.lusha.com/prospecting/contact/enrich \
  --header 'api_key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "requestId": "b6effae6-35b8-493d-91aa-7d3b1b7c7dc7",
    "contactIds": [
      "37b4c536-eaec-11ef-ad4b-a75f8e9e1484",
      "48c5d647-fbfd-22fg-be5c-b86g9f0f2595"
    ]
  }'

{
  "requestId": "b6effae6-35b8-493d-91aa-7d3b1b7c7dc7",
  "contactIds": [
    "37b4c536-eaec-11ef-ad4b-a75f8e9e1484",
    "48c5d647-fbfd-22fg-be5c-b86g9f0f2595"
  ]
}

Response

200 - Success

string

The requestId that was used in the request.

object[]

Array of enriched contact objects, one per requested ID.

Show contact fields

string

The contact ID from the enrichment request.

boolean

Whether enrichment succeeded for this contact.

object

Full contact profile. Only present when isSuccess is true.

Show data fields

string

First name. Example: "Carolina"

string

Last name. Example: "Portela"

string

Full name. Example: "Carolina Portela"

boolean

Whether this contact has already been revealed by any user in your account.

string

Current job title. Example: "Solutions Engineer"

object[]

Seniority level details.

Show seniority fields

number

Seniority ID. Example: 4

string

Seniority label. Example: "senior"

string[]

Departments. Example: ["Engineering & Technical"]

object

Contact’s location.

Show location fields

string

Example: "Boston"

string

Example: "Massachusetts"

string

Example: "United States"

string

ISO 3166-1 alpha-2 code. Example: "US"

string

Example: "North America"

object[]

Email addresses with metadata.

Show email fields

string

Email address. Example: "carolina@lusha.com"

string

Type of email. Values: "work", "private"

string

Confidence rating. Example: "A+"

string

Last updated date. Example: "2024-03-01"

object[]

Phone numbers with metadata.

Show phone fields

string

Phone number in E.164 format. Example: "+12125551234"

string

Type of phone. Values: "Mobile", "Direct", "Phone"

boolean

Whether the number is on the DNC list.

string

Last updated date. Example: "2024-03-01"

Social profile URLs.

Show social fields

LinkedIn profile URL.

Twitter/X profile URL.

number

Lusha company identifier. Example: 3553744

string

Company name. Example: "Lusha"

object

Additional company data including revenueRange, funding, intent, mainIndustry/subIndustry, and technologies.

Error codes

Status	Meaning
`400`	Validation failed - check that `requestId` and `contactIds` are present and valid.
`401`	Unauthorized - your API key is missing or invalid.
`403`	Forbidden - `revealEmails` or `revealPhones` requires the Unified Credits plan.
`429`	Too many requests - you have exceeded the rate limit.
`500`	Internal server error - retry with exponential backoff.

{
  "requestId": "b6effae6-35b8-493d-91aa-7d3b1b7c7dc7",
  "contacts": [
    {
      "id": "37b4c536-eaec-11ef-ad4b-a75f8e9e1484",
      "isSuccess": true,
      "data": {
        "firstName": "Carolina",
        "lastName": "Portela",
        "fullName": "Carolina Portela",
        "jobTitle": "Solutions Engineer",
        "departments": ["Engineering & Technical"],
        "seniority": [{ "id": 4, "value": "senior" }],
        "location": {
          "city": "Boston",
          "state": "Massachusetts",
          "country": "United States",
          "country_iso2": "US",
          "continent": "North America"
        },
        "emailAddresses": [
          {
            "email": "carolina@lusha.com",
            "emailType": "work",
            "emailConfidence": "A+",
            "updateDate": "2024-03-01"
          }
        ],
        "phoneNumbers": [
          {
            "number": "+16175551234",
            "phoneType": "Mobile",
            "doNotCall": false,
            "updateDate": "2024-03-01"
          }
        ],
        "socialLinks": {
          "linkedin": "https://www.linkedin.com/in/carolinaportela/"
        },
        "companyId": 3553744,
        "companyName": "Lusha"
      }
    }
  ]
}

{
  "statusCode": 403,
  "message": "Forbidden",
  "errors": ["revealEmails is only available on the Unified Credits plan"]
}

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

requestId

string

required

The requestId generated in the Prospecting Search response (UUID)

Example:

"b6effae6-35b8-493d-91aa-7d3b1b7c7dc7"

contactIds

string[]

required

An array containing the contact IDs for enrichment. Min 1, max 100.

Example:

["37b4c536-eaec-11ef-ad4b-a75f8e9e1484"]

revealEmails

boolean

Set revealEmails=true to retrieve only the email address of the contact. Only available to customers on the Unified Credits pricing plan.

Example:

false

revealPhones

boolean

Set revealPhones=true to retrieve only the phone number of the contact. Only available to customers on the Unified Credits pricing plan.

Example:

true

Response

Enriched contact data

requestId

string

The requestId that was used in the request

contacts

object[]

Show child attributes

⌘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": "b6effae6-35b8-493d-91aa-7d3b1b7c7dc7",
  "contacts": [
    {
      "id": "37b4c536-eaec-11ef-ad4b-a75f8e9e1484",
      "isSuccess": true,
      "data": {
        "firstName": "Carolina",
        "lastName": "Portela",
        "fullName": "Carolina Portela",
        "jobTitle": "Solutions Engineer",
        "departments": ["Engineering & Technical"],
        "seniority": [{ "id": 4, "value": "senior" }],
        "location": {
          "city": "Boston",
          "state": "Massachusetts",
          "country": "United States",
          "country_iso2": "US",
          "continent": "North America"
        },
        "emailAddresses": [
          {
            "email": "carolina@lusha.com",
            "emailType": "work",
            "emailConfidence": "A+",
            "updateDate": "2024-03-01"
          }
        ],
        "phoneNumbers": [
          {
            "number": "+16175551234",
            "phoneType": "Mobile",
            "doNotCall": false,
            "updateDate": "2024-03-01"
          }
        ],
        "socialLinks": {
          "linkedin": "https://www.linkedin.com/in/carolinaportela/"
        },
        "companyId": 3553744,
        "companyName": "Lusha"
      }
    }
  ]
}

{
  "statusCode": 403,
  "message": "Forbidden",
  "errors": ["revealEmails is only available on the Unified Credits plan"]
}

​Endpoint

​Request body

​Example request

​Response

​200 - Success

​Error codes

Authorizations

Body

Response

Endpoint

Request body

Example request

Response

200 - Success

Error codes