Descovo

// WATERFALL ENRICHMENT

Waterfall enrichment: what it is, how it is priced, and an API that does it

Updated November 20, 2026

Waterfall enrichment means looking for the same contact detail in several data sources, one after another, instead of relying on one. It can find people a single source misses. Descovo's Standard and Turbo reveals work this way behind one API call, and charge a fixed price per field only when something is found.

What waterfall enrichment means

No single data source knows everyone. One vendor has a work email for a person and no phone; another has the phone; a third has neither. A waterfall asks the first source, and if it comes back empty or with something unusable, asks the next, and so on down the list. The name comes from the way a request falls from one source to the next.

The alternative is a single-source lookup: one database, one answer. It is faster and cheaper, and it finds fewer people.

Why a waterfall finds more people, and what it costs

  • Coverage goes up. Each extra source can only add people the earlier ones missed.
  • Time goes up. Sources are tried in turn, so a person who is only found late takes longer.
  • Cost can go up, depending on who runs it. If each source is paid per lookup, a person who is found late, or never, has still cost several lookups.
  • Quality needs a check at the end. More sources means more chances of a stale address, so results are worth validating before they are returned.

Three ways to get a waterfall

Ways to run waterfall enrichment
ApproachHow it worksWhat to watch
Build it yourselfSign contracts with several data vendors and write the code that calls them in orderYou pay each vendor on its own terms, including for misses where they charge for them, and you maintain the integrations
Configure it in a platformPick vendors and their order inside a tool. Clay, for example, lets you "run multi-provider waterfalls" across "150+ providers" and bring your own API keys (pricing)Cost depends on the vendors and steps you choose
Call an API that has one built inSend one request; the sequence runs behind it and you get one answerYou cannot choose or reorder the sources

How waterfall enrichment is priced

Pricing varies more than the idea does. Apollo's API documentation, for example, says its phone waterfall "typically uses 8–25 credits" with some configurations at 45 or more, its email waterfall "typically uses 1–4 credits" with some at 20 or more, and that some vendors consume credits per lookup even when no data is found (API pricing, read November 20, 2026).

So the questions worth asking of any waterfall are: is the price fixed or does it depend on which source answers, and do I pay when nothing is found?

How Descovo applies it

Descovo offers three reveal depths. Standard and Turbo reveals check several data sources in sequence for the same person; Lite is a shallower, cheaper lookup. The sequence is built in: you choose a depth, not the sources.

Credits per field found, by reveal mode
ModeWork emailDirect phoneBoth
Lite112
Standard235
Turbo358
  • The price is fixed per field found. A work email is 2 credits and a direct phone 3 on Standard, however the answer was found.
  • A miss is free. If the sequence ends with nothing, nothing is charged.
  • You pick the depth per request. A common pattern is Standard first, then Turbo only for the people Standard missed.

A reveal is charged only for the fields it finds: 2 credits for a work email, 3 for a direct phone, nothing when nothing is found.

Lite uses a lower-yield lookup. Standard balances speed and coverage. Turbo prioritizes speed and uses a premium enrichment stack at a higher cost.

A waterfall in one request

Terminal
curl -X POST https://api.descovo.com/v1/contacts/reveal \
  -H "Authorization: Bearer $DESCOVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"linkedinUrl":"https://www.linkedin.com/in/satyanadella","enrichmentType":{"getWorkEmails":true,"getPersonalEmails":false,"getPhoneNumbers":false},"validateEmails":true}'

For a list, the bulk endpoint takes up to 2,000 profile URLs per request and refunds anything not found when the job finishes.

When a built-in waterfall is the wrong choice

  • You need to control which vendors are used, for contractual or compliance reasons. Use a platform where you configure the sequence, or build your own.
  • You already pay for several data vendors and want to use those contracts first.
  • You need to know which source produced each result. Descovo does not report that.

Frequently asked questions

What is waterfall enrichment?
Waterfall enrichment is looking for the same contact detail, such as a work email or a phone number, in several data sources one after another, moving to the next source when the current one has nothing.
Why is it called a waterfall?
Because a request falls from one data source to the next until one of them returns a result.
Is waterfall enrichment more expensive than a single lookup?
It depends on who runs it. Where each source is billed per lookup, a late or missing result costs several lookups. With Descovo the price is fixed per field found and a miss is free.
Does Descovo do waterfall enrichment?
Yes. Standard and Turbo reveals check several data sources in sequence for the same person. Lite is a shallower, cheaper lookup.
Can I choose which sources Descovo checks?
No. The sequence is built in. You choose a depth, Lite, Standard or Turbo, on each request.
What does Descovo charge for a waterfall lookup?
On Standard reveal, 2 credits for a work email and 3 for a direct phone, only when found. Plans start free with 500 credits, then $99 a month for 5,000 credits.

TRY IT

Run a waterfall lookup in one request.

A new account starts with 500 credits and no card. That is enough to find 250 work emails, or 100 people with both a work email and a direct phone.

Sources