What is waterfall enrichment?
Waterfall enrichment is a data enrichment method that queries several providers in a set order until a field such as a mobile number or work email is found. Each provider only sees the records the providers before it missed.
Also called: enrichment waterfall · multi-provider enrichment · sequential enrichment
Waterfall enrichment in practice
A waterfall exists because no single provider holds every mobile number or email. By chaining providers, a team raises the share of records that end up with a filled field, while paying each provider only for what it adds.
The order matters. Teams usually put the provider with the best results on their own sample first, then the others. Pay-per-result providers can sit anywhere, because a miss costs nothing. Flat-fee or per-request providers are usually placed where their hit rate justifies the charge.
Waterfalls are built in tools like Clay, in GTM workflow builders, or in code. Forager is designed to be one slot in your waterfall: send the key, get a number or an email back, pay only when something is found.
How an enrichment waterfall runs
- Order the providersDecide the sequence per field. The sequence for mobiles can differ from the sequence for work emails.
- Send the key to provider 1A LinkedIn URL, email or name and company. If a value comes back, the record stops here.
- Pass misses downOnly records with no value go to provider 2, then 3. Each slot sees a smaller, harder set.
- Validate and stopSome teams add a validation step after a hit (does the number connect, does the email bounce) before the waterfall stops for that record.
- Count the costAdd up what each slot charged. With pay-per-result slots the misses are free; with per-request slots they are not.
Waterfall vs single provider
| Waterfall | Single provider | |
|---|---|---|
| Hit rate | The union of every provider on your sample | One provider's hit rate |
| Cost per record | Sum of what each slot charged; misses on pay-per-result slots cost nothing | One price, charged per that provider's rule |
| Setup | A workflow tool or code that passes misses down | One API call |
| Quality control | Needs a validation step, since each provider verifies differently | One provider's own checks |
Limits and when not to use it
- More slots mean more vendors to contract with and more rules to keep in step. Three slots that each add something beat eight that mostly repeat each other.
- A hit in slot 1 stops the record, even when slot 2 would have returned a better value. Put the provider you trust most for that field first.
- Per-request providers charge for the records they miss. Place them where their hit rate pays for the misses, or after the pay-per-result slots.
How waterfall enrichment works with Forager
Forager is built as a waterfall slot: mobile numbers at 15 credits per number found, work emails at 5 credits per email found, personal emails at 5 credits per email found. A mobile or email lookup that returns nothing costs 0 credits. In Clay, Forager is a native enrichment provider you can add as a column in your waterfall.
- Recipe: add a mobile-number slot to a multi-provider enrichment waterfall
- Forager in Clay
- Mobile numbers
- Docs: phone number lookup API reference
- $5 free credits
- No credit card
- Run your sample
Questions about waterfall enrichment
What is waterfall enrichment?
A chain of data providers queried in order. A record goes to the first provider; if that provider returns nothing, the record goes to the next. The chain stops for a record as soon as one provider returns the field.
Why use a waterfall instead of one provider?
No single provider holds every mobile or email. Chaining providers raises the share of records that end up filled, and with pay-per-result providers the extra slots cost nothing on misses.
Which provider should go first in a waterfall?
The one with the best results on your own sample for that field. Run the same records through each candidate, compare hit rate and whether the numbers connect, and order by that.
Does Forager charge when it is a slot that finds nothing?
No. A mobile or email lookup that returns nothing costs 0 credits. You pay 15 credits per mobile found and 5 credits per work email found.
Can I add Forager to a Clay waterfall?
Yes. Forager is a native enrichment provider in Clay, so it can be added as a column in a waterfall alongside your other providers.
Written answers are not available right now. The matching pages above still help, or book a demo and ask the team.
- $5 free credits
- No credit card
- Run your sample
Keep reading
How-to guides
Tools
Related terms
Sources
- Forager docs: credits and pricing (read Nov 1, 2026)
- Forager docs: waterfall enrichment recipe (read Nov 1, 2026)