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

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

Source page: https://descovo.com/waterfall-enrichment
Updated: November 20, 2026

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

| Approach | How it works | What to watch |
|---|---|---|
| Build it yourself | Sign contracts with several data vendors and write the code that calls them in order | You pay each vendor on its own terms, including for misses where they charge for them, and you maintain the integrations |
| Configure it in a platform | Pick 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](https://www.clay.com/pricing)) | Cost depends on the vendors and steps you choose |
| Call an API that has one built in | Send one request; the sequence runs behind it and you get one answer | You 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](https://docs.apollo.io/docs/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.

| Mode | Work email | Direct phone | Both |
|---|---|---|---|
| Lite | 1 | 1 | 2 |
| Standard | 2 | 3 | 5 |
| Turbo | 3 | 5 | 8 |

- **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

Standard:

```bash
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}'
```

Turbo:

```bash
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":true},"mode":"turbo"}'
```

For a list, the [bulk endpoint](https://descovo.com/bulk-email-finder) 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.

## Sources

- [Apollo API pricing documentation](https://docs.apollo.io/docs/api-pricing), read November 20, 2026
- [Clay pricing](https://www.clay.com/pricing), read November 20, 2026

## Next

- [Get an API key](https://descovo.com/sign-up)
- [REST reference](https://descovo.com/docs/rest)
- [Contact enrichment API](https://descovo.com/contact-enrichment-api)
- [Clay alternative: enrichment as an API](https://descovo.com/alternatives/clay)
- [Phone number enrichment API](https://descovo.com/phone-number-enrichment-api)
