Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.databar.ai/llms.txt

Use this file to discover all available pages before exploring further.

A waterfall chains multiple data providers together and tries them one by one. If the first provider returns no result, the second is tried automatically. The process continues down the chain until a provider succeeds or all providers have been exhausted.
Waterfall diagram showing sequential provider fallback from Provider A to Provider B to Provider C

​
Why use waterfalls

No single data provider covers every record. One service might find 60% of emails, another might find a different 50%, and a third might cover niche domains the others miss. Running them manually and merging results is tedious and error-prone. Waterfalls solve this by automating the fallback logic. You define the provider order once, and Databar handles the rest. The first successful result is returned, giving you the highest possible coverage with a single call. Waterfalls are especially useful for:
  • Email finding — try multiple email lookup providers until a valid address is found.
  • Company data — aggregate firmographic details from whichever provider has the best coverage for a given domain.
  • Contact information — combine phone, social, and address lookups across several sources.

​
Available waterfalls

Databar offers pre-built waterfalls for common use cases:
  • Email finder — chains multiple email lookup providers. Accepts a name and company (or domain) and returns a verified email address.
  • Company data — returns firmographic information including funding rounds, addresses and locations, industries, and estimated revenue. Standard fields are normalized across providers.
Each waterfall lists its available providers and supported input parameters. Browse the full catalog via the Waterfalls API or in the Databar UI.

​
Email verification

Email finder waterfalls support up to three email verifiers. When a provider returns an email, the verifier checks its deliverability before accepting the result. If the email fails verification, the waterfall falls back to the next provider in the chain. This means the final result is not just found but verified, which significantly improves deliverability for outbound campaigns.

​
Provider ordering

The order of providers in a waterfall matters for cost optimization. Databar processes providers from top to bottom and stops at the first successful result. Place your cheapest or highest-coverage providers first to minimize cost per lookup. For example, if Provider A costs 1 credit and covers 40% of records while Provider B costs 3 credits and covers 70%, putting Provider A first means you only pay the higher price for the 60% of records that Provider A misses.

​
Using waterfalls in tables

Adding a waterfall to your table works the same way as adding a single enrichment:
  1. Click Enrich in the top-right corner of your table.
  2. Select Add a new Enrichment and switch to the Waterfalls tab.
  3. Choose a waterfall and map its input parameters to your table columns.
  4. Select the response columns you want added to your table.
  5. Click Run to process your rows.
All table features apply to waterfalls — run conditions, automations, cell-level statuses, and run strategies (run all, run empty, run single row).

​
Using waterfalls headlessly

You can run waterfalls programmatically without a table using the REST API, Python SDK, CLI, or MCP server. 
curl -X POST "https://api.databar.ai/v1/waterfalls/WATERFALL_ID/run" \
  -H "x-apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "full_name": "Jane Doe",
      "company": "Acme Corp"
    }
  }'
For bulk runs, use the bulk endpoint to process multiple records in a single request.
Task data from headless runs is stored for 24 hours. Retrieve and save your results before they expire.

​
Recent updates

  • Company data waterfall now includes additional standard fields: funding rounds, addresses and locations, industries, and estimated revenue.
  • People Data Labs added as a provider in company data waterfalls.
  • FindyMail added as a provider in email finder waterfalls.

​
Next steps

Enrichments

Learn how single-provider enrichments work.

Waterfall email finder guide

Step-by-step guide to finding verified emails with waterfalls.

Waterfalls API

Browse and run waterfalls programmatically.