Data Waterfall in the Lusha API
Lusha is the data layer underneath your workflows. When Lusha's own data has no match for a work email or phone, Data Waterfall falls through to the additional providers your admin turned on, in the same request, with one integration and one credit balance.

What it is
Data Waterfall extends contact enrichment in the Lusha API. Lusha checks its own data first, and if a requested work email or phone is missing, the request falls through to the third-party providers enabled on your account, in an order Lusha determines. Once an admin turns it on, it runs automatically on every eligible Enrich Contacts call.
- Lusha data firstLusha's own data is checked first, and providers fill only what is missing.
- One requestResults come back in the same Enrich Contacts call, with no extra integration.
- Provider controlAdmins choose which providers Waterfall can use and can turn any of them off.
- Pay on matchCredits are used only when a field is filled, at that provider's own credit rate.
Good to know
Available on all paid plans. Admins turn it on under Account Settings, Waterfall. Provider credit rates vary, are shown in Waterfall settings and can be higher than a standard Lusha reveal. Matches stay available account-wide for 30 days. Phone numbers from Waterfall providers are not scrubbed against Do Not Call lists. Data Waterfall is now also available in Lusha MCP and Workspace.