Skip to main content
Fill in missing work emails and phones on Enrich calls by falling through to your enabled third-party providers. Data Waterfall is an enhancement to contact enrichment. When Lusha’s own data has no match for a requested field, the request automatically falls through to your enabled third-party providers to fill the gap - extra reach on hard-to-match contacts, on top of standard enrichment. For paid plan users: Enable Data Waterfall Don’t have a plan yet? Explore plans to access Data Waterfall, along with additional features and capabilities.

​
Key concepts

  • Waterfall Reveal - the enrichment behavior itself: Lusha checks its own data first, then falls through to your enabled providers for any missing email or phone.
  • Provider - a third-party data vendor you turn on under Account Settings → Waterfall. Lusha determines the query order across providers. Waterfall currently spans 6 providers.
  • Async provider - a provider that processes the request in the background instead of returning a result instantly. You retrieve the results once the job completes. See Async providers below.
  • Partial Profiles - contacts the Search API has identified but doesn’t yet have contact details for. Pairing Partial Profiles with Data Waterfall gets you more contacts and more complete data.

​
Availability

Data Waterfall is currently available for:
  • API
  • MCP - enrichment through AI chats
Coming soon: Workspace and Plugin support.
Data Waterfall is available on all paid plans. Don’t have a plan yet? Explore plans to access Data Waterfall, along with additional features and capabilities.
The Waterfall settings page is only accessible to Admins and Managers on paid plans. See Account settings - Waterfall tab for details.

​
Turning it on

An account admin enables and configures Data Waterfall from Account Settings → Waterfall. From there, admins can:
  • Turn Data Waterfall on or off for the account
  • Choose which additional providers Waterfall can use
  • Disable individual providers at any time
Once enabled, Waterfall runs automatically on every eligible POST /v3/contacts/enrich request. No additional configuration is needed in your API or MCP request. For full parameter reference, see the Enrich Contacts API documentation.

​
How Data Waterfall works

  1. Lusha checks its own data first.
  2. If the requested email or phone is missing, Waterfall checks the additional providers enabled on your account.
  3. Providers are checked in an order determined by Lusha.
  4. Waterfall stops at the first successful match.
  5. You pay only for successful matches.
Waterfall works only on contacts Lusha already has. It does not search for new contacts or replace Search or Prospecting.
For broader coverage, pair Data Waterfall with Partial Profiles. Partial Profiles (Search API) surfaces contacts Lusha has identified but doesn’t currently have contact details for. Data Waterfall (Enrich) can then try to fill in the missing email or phone when you enrich those contacts.

​
Async providers

Most providers answer inside the original Enrich call. Some providers process requests in the background instead, and return their results a short time later.
  • MCP handles this automatically - no extra steps needed.
  • API users get a job back in the Enrich response when an async provider is still working. Wait job.retryAfter seconds, then poll Get Contacts Enrich Job with the job ID until it completes, and merge the returned contacts into your results by id.
Polling for a job’s results is free. Lusha bills each data point only once, on whichever call delivers it.

​
Pricing

Data Waterfall uses standard reveal pricing, flat across every vendor:
  • 2 credits per work email successfully revealed
  • 8 credits per phone successfully revealed
  • No charge for unsuccessful lookups - credits are charged only on a match
Use of Data Waterfall is subject to Lusha’s Supplementary Terms. You’re all set! Turn on Data Waterfall under Account Settings → Waterfall and your enrich calls will start reaching further automatically.