# Data Waterfall in the Lusha API

Canonical: <https://www.lusha.com/releases/data-waterfall-in-the-lusha-api/>

Released July 27, 2026 · Week of Jul 27

Topics: API, Enrichment

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.

![Contact table filled by Waterfall enrichment, showing which provider confirmed each email](https://www.lusha.com/wp-content/uploads/2026/11/Waterfall-enrichment-hd-1024x608.webp)

## 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 first** Lusha's own data is checked first, and providers fill only what is missing.
- **One request** Results come back in the same Enrich Contacts call, with no extra integration.
- **Provider control** Admins choose which providers Waterfall can use and can turn any of them off.
- **Pay on match** Credits are used only when a field is filled, at that provider's own credit rate.

[Try it](https://www.lusha.com/waterfall-enrichment/?utm_source=lusha_website&utm_medium=whats_new&utm_campaign=data-waterfall-in-the-lusha-api) · [Learn more](https://docs.lusha.com/user-guide/lushas-api/data-waterfall)

## 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.