Enrich Contacts

Reveal full contact data for contacts you've already found via Search Contacts.

Pass up to 100 contact ids (from the search response). Use the reveal field to control what gets unlocked:

• emails — work and personal email addresses
• phones — mobile and direct phone numbers
• Omit reveal to get both by default

---

<span style="color: #8b5cf6;">BETA</span> Waterfall Reveal

Fall through to your enabled third-party providers when Lusha's own data has no match, for extra reach on hard-to-match contacts.

If Data Waterfall is enabled on your account, with specific providers turned on under Account > Waterfall, the waterfall runs automatically on every Enrich Contacts call - you don't need to pass anything to trigger it.

Pass waterfallEnabled: false to opt a specific call out:

                "reveal": ["emails", "phones"],
                "waterfallEnabled": false

• reveal controls which fields come back.
• waterfallEnabled controls whether the waterfall runs for this call at all. Defaults to true whenever Data Waterfall is enabled on your account; pass false to disable it just for this call.
• Provider order isn't configurable - Lusha manages that internally.
• If Data Waterfall is off or no providers are enabled on your account, waterfallEnabled has no effect either way.
• This feature is in limited beta and not yet available on all accounts. Contact support@lusha.com to request access.

---

Tip: If canReveal.credits is 0 in the search response, that data has already been revealed for your account — re-enriching it is free.

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

Persisting to a table: Pass tableId to also add these contacts to an existing table and populate the Work email / Phone columns. See Contacts Tables.

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

{
  "results": [
    {
      "id": "4389064704",
      "firstName": "Orit",
      "lastName": "Shilvock",
      "fullName": "Orit Shilvock",
      "jobTitle": {
        "title": "Vice President of Partnerships",
        "departments": [
          "Business Development"
        ],
        "seniority": "Vice President"
      },
      "location": {
        "country": "Israel",
        "countryIso2": "IL",
        "state": "Tel Aviv District",
        "city": "Tel Aviv",
        "continent": "Asia",
        "coordinates": [
          34.78057098388672,
          32.08087921142578
        ]
      },
      "tags": [
        {
          "color": "#FF5733"
        }
      ],
      "emails": [
        {
          "email": "orit.shilvock@lusha.com",
          "type": "work",
          "confidence": "A+",
          "updateDate": "2026-04-23"
        }
      ],
      "phones": [
        {
          "number": "+14155551234",
          "type": "mobile",
          "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",
        "xUrl": "https://twitter.com/lushaofficial"
      },
      "updateDate": "2026-04-23",
      "error": {
        "code": "NOT_FOUND",
        "message": "Contact not found"
      }
    }
  ],
  "tableWrite": {
    "tableId": "482910",
    "added": 3,
    "alreadyPresent": 2,
    "rowsProcessed": 5,
    "rowsCharged": 5
  },
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}