Enrich Contacts

POST

contacts

enrich

curl --request POST \
  --url https://api.lusha.com/v3/contacts/enrich \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "ids": [
    "4389064654",
    "4389064624"
  ],
  "reveal": [
    "emails",
    "phones"
  ]
}
'

{
  "requestId": "71581363-f73d-46e1-9115-ecbd771b964b",
  "results": [
    {
      "id": "4389064654",
      "firstName": "Daniel",
      "lastName": "Turgeman",
      "fullName": "Daniel Turgeman",
      "jobTitle": {
        "title": "Technical Product Manager",
        "departments": [
          "Product"
        ],
        "seniority": "Manager"
      },
      "location": {
        "country": "Israel",
        "countryIso2": "IL",
        "city": "Tel Aviv",
        "continent": "Asia",
        "coordinates": [
          34.78057098388672,
          32.08087921142578
        ],
        "isEuContact": false
      },
      "tags": [],
      "emails": [
        {
          "email": "daniel.t@lusha.com",
          "type": "work",
          "confidence": "A+",
          "updateDate": "2026-04-23"
        }
      ],
      "phones": [],
      "company": {
        "id": "16303253",
        "name": "Lusha",
        "domain": "www.lusha.com",
        "industry": "Technology, Information & Media"
      },
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/in/daniel-turgeman-49676b161"
      },
      "previousEmployment": [],
      "updateDate": "2026-04-23"
    }
  ],
  "billing": {
    "creditsCharged": 2,
    "resultsReturned": 2
  }
}

Use this endpoint to reveal full contact data for contacts you’ve already found via Search Contacts. Pass the Lusha id from a search result, and choose what to unlock with reveal.

Enrich Contacts only works with id values returned by Search Contacts. It doesn’t accept email, linkedinUrl, or name-based identifiers. To search and reveal in one call, use Search and Enrich Contacts instead.

Endpoint

POST https://api.lusha.com/v3/contacts/enrich

Authentication

string

required

Your Lusha API key.

Request body

string[]

required

Up to 100 Lusha contact IDs, from a Search Contacts response.Example: ["4389064654", "4389064624"]

string[]

What to unlock for each contact. Omit this field to get both by default.Allowed values: emails, phones

Response

string

Unique ID for this request, in UUID format.

object[]

One entry per contact id you passed in.

Show result fields

string

The Lusha contact ID.

string

First name.

string

Last name.

string

Full name.

object

Show properties

string

Example: Vice President of Partnerships

string[]

Example: ["Business Development"]

string

Example: Vice President

object

Show properties

string

Example: Israel

string

Example: IL

string

Example: Tel Aviv District

string

Example: Tel Aviv

string

Example: Asia

number[]

[longitude, latitude]. Example: [34.78057, 32.08088]

boolean

Whether the contact is located in the EU.

object[]

Present when reveal includes (or omits) emails.

Show properties

string

Example: orit.shilvock@lusha.com

string

One of work, private, unknown.

string

Confidence score. Example: A+

string

Last-updated date, YYYY-MM-DD.

object[]

Present when reveal includes (or omits) phones.

Show properties

string

E.164 format. Example: +14155551234

string

One of mobile, direct, work, unknown.

boolean

Whether this number is on the Do Not Call list.

string

Last-updated date, YYYY-MM-DD.

object

Show properties

string

Example: 16303253

string

Example: Lusha

string

Example: www.lusha.com

string

Example: Technology, Information & Media

Show properties

string

LinkedIn profile URL.

string

X (Twitter) profile URL.

object[]

Prior roles.

Show properties

object

Show properties

string

object

Show properties

string

string[]

string

object[]

Tags you’ve applied to this contact in Lusha.

Show properties

string

Hex code. Example: #FF5733

string

Date the record was last updated, YYYY-MM-DD.

object

Present instead of profile data when enrichment fails for this id.

Show properties

string

One of NOT_FOUND, COMPLIANCE_RESTRICTED, ENRICH_FAILED.

string

Human-readable description.

object

Show properties

integer

Credits charged for this request.

integer

Number of successful results.

Billing: Charged per revealed field (email or phone) via per-datapoint pricing.

Error codes

Status	Meaning
`400`	Bad request - invalid input data
`401`	Unauthorized - invalid or missing API key
`402`	Payment required - insufficient credits
`403`	Forbidden - account inactive or V3 access not enabled
`429`	Too many requests - rate limit exceeded

Example

curl --request POST \
  --url https://api.lusha.com/v3/contacts/enrich \
  --header 'api_key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "ids": ["4389064654", "4389064624"],
    "reveal": ["emails", "phones"]
  }'

{
  "ids": ["4389064654", "4389064624"],
  "reveal": ["emails", "phones"]
}

Example response

{
  "requestId": "6e4b1192-9440-42c4-9a3e-793ddef6d73c",
  "results": [
    {
      "id": "4389064654",
      "firstName": "Orit",
      "lastName": "Shilvock",
      "fullName": "Orit Shilvock",
      "jobTitle": {
        "title": "Vice President of Partnerships",
        "departments": ["Business Development"],
        "seniority": "Vice President"
      },
      "location": {
        "country": "Israel",
        "countryIso2": "IL",
        "city": "Tel Aviv",
        "continent": "Asia"
      },
      "emails": [
        { "email": "orit.shilvock@lusha.com", "type": "work", "confidence": "A+", "updateDate": "2026-04-23" }
      ],
      "phones": [
        { "number": "+14155551234", "type": "mobile", "doNotCall": false, "updateDate": "2026-04-23" }
      ],
      "company": {
        "id": "16303253",
        "name": "Lusha",
        "domain": "www.lusha.com",
        "industry": "Technology, Information & Media"
      },
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/in/orit-shilvock-6243bb5"
      },
      "updateDate": "2026-04-23"
    }
  ],
  "billing": {
    "creditsCharged": 2,
    "resultsReturned": 1
  }
}

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

ids

string[]

required

Required array length: 1 - 100 elements

Example:

["4389064654", "4389064624"]

reveal

enum<string>[]

Available options:

emails,

phones

Example:

["emails", "phones"]

waterfallEnabled

boolean

default:true

Whether this call is allowed to fall through to your enabled third-party providers when Lusha's own data has no match, for the fields requested via reveal. Defaults to true whenever Data Waterfall is enabled on your account (Account > Waterfall) - pass false to opt this specific call out. Has no effect if Data Waterfall or no providers are enabled on your account. Provider order isn't configurable - Lusha manages that internally.

Example:

false

tableId

string

Optional. If provided, these contacts are also added to this table (if not already present) and the revealed fields' columns are populated. See the Tables API.

Example:

"482910"

Response

Successful response

requestId

string<uuid>

results

object[]

Show child attributes

tableWrite

object

Added to a Prospecting, Enrich, Signals, or Lookalike response when tableId is passed on the request. The primary response is unaffected even if the table write fails.

Show child attributes

billing

object

Credit usage summary for a V3 API request

Show child attributes

⌘I

curl --request POST \
  --url https://api.lusha.com/v3/contacts/enrich \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "ids": [
    "4389064654",
    "4389064624"
  ],
  "reveal": [
    "emails",
    "phones"
  ]
}
'

{
  "requestId": "71581363-f73d-46e1-9115-ecbd771b964b",
  "results": [
    {
      "id": "4389064654",
      "firstName": "Daniel",
      "lastName": "Turgeman",
      "fullName": "Daniel Turgeman",
      "jobTitle": {
        "title": "Technical Product Manager",
        "departments": [
          "Product"
        ],
        "seniority": "Manager"
      },
      "location": {
        "country": "Israel",
        "countryIso2": "IL",
        "city": "Tel Aviv",
        "continent": "Asia",
        "coordinates": [
          34.78057098388672,
          32.08087921142578
        ],
        "isEuContact": false
      },
      "tags": [],
      "emails": [
        {
          "email": "daniel.t@lusha.com",
          "type": "work",
          "confidence": "A+",
          "updateDate": "2026-04-23"
        }
      ],
      "phones": [],
      "company": {
        "id": "16303253",
        "name": "Lusha",
        "domain": "www.lusha.com",
        "industry": "Technology, Information & Media"
      },
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/in/daniel-turgeman-49676b161"
      },
      "previousEmployment": [],
      "updateDate": "2026-04-23"
    }
  ],
  "billing": {
    "creditsCharged": 2,
    "resultsReturned": 2
  }
}

Overview

Resources

Endpoints

Endpoint

Authentication

Request body

Response

Error codes

Example

Authorizations

Body

Response

​Endpoint

​Authentication

​Request body

​Response

​Error codes

​Example

Authorizations

Body

Response

Endpoint

Authentication

Request body

Response

Error codes

Example