Waterfall Contact Enrichment API

Verified emails & profiles, instantly

Find real-time verified emails or match emails to complete business profiles

Input type

You Input

curl --request POST \
  --url https://api.waterfall.io/v1/enrichment/contact \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
  "full_name": "Jane Doe",
  "domain": "acme.com"
}'

Your Receive

// GET /v1/enrichment/contact?job_id={job_id}
{
  "status": "SUCCEEDED",
  "output": {
    "person": {
      "first_name": "Jane",
      "last_name": "Doe",
      "professional_email": "jane.doe@acme.com",
      "email_verified": true,
      "email_verified_status": "safe",
      "title": "Head of Sales",
      "seniority": "Director",
      "department": "Sales",
      "company_name": "Acme Corp",
      "company_domain": "acme.com"
    }
  }
}

You Input

curl --request POST \
  --url https://api.waterfall.io/v1/enrichment/contact \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
  "linkedin": "https://www.linkedin.com/in/jane-doe-abc123/"
}'

Your Receive

// GET /v1/enrichment/contact?job_id={job_id}
{
  "status": "SUCCEEDED",
  "output": {
    "person": {
      "first_name": "Jane",
      "last_name": "Doe",
      "linkedin_url": "https://www.linkedin.com/in/jane-doe-abc123/",
      "professional_email": "jane.doe@acme.com",
      "email_verified": true,
      "email_confidence": "high",
      "title": "Head of Sales",
      "company_name": "Acme Corp",
      "company_domain": "acme.com"
    }
  }
}

You Input

curl --request POST \
  --url https://api.waterfall.io/v1/enrichment/contact \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
  "email": "jane.doe@acme.com"
}'

Your Receive

// GET /v1/enrichment/contact?job_id={job_id}
{
  "status": "SUCCEEDED",
  "output": {
    "person": {
      "first_name": "Jane",
      "last_name": "Doe",
      "professional_email": "jane.doe@acme.com",
      "email_verified_status": "safe",
      "smtp_provider": "Google",
      "title": "Head of Sales",
      "seniority": "Director",
      "department": "Sales",
      "company_name": "Acme Corp",
      "location": "San Francisco, California, United States"
    }
  }
}

Methodology

What makes Waterfall different

Real-time Email Verification

Quality

Every email is verified at the moment of your request, not from cached databases. This ensures the lowest possible bounce rates for your campaigns.

Unmatched Global Data Coverage from 30+ Sources

Coverage

Certain vendors specialize in specific regions or industries. Our aggregation methodology combines their strengths to deliver superior coverage across all geographies and sectors.

Superior Email and Profile Finding Accuracy

Accuracy

5+ years of data processing experience means we handle every edge case, ensuring you get accurately matched data, not just technically valid emails or profiles that lead nowhere.

Pay Only for Accurate Results.

Pricing

We offer outcome-based pricing — Waterfall deducts credits only when we return a verified email or a matched profile, even though we incur costs querying our vendors on every request. Empty results are free. One credit covers the whole waterfall however many sources it takes to reach the answer, so your cost per result falls as coverage rises instead of multiplying with every vendor you add.

Customers

Hear what our customers say about us

Stop comparing vendors on their numbers. Run the benchmark on yours.

Three commercial reasons to start

Flexible Commercials
Best International Coverage
High Data Accuracy

Three technical reasons to start

One single API
Unified Response & Request structure
Sync & Async solution

Visit our API Documentation

What teams build with the Contact Enrichment API

Real-time Email Discovery

Find real-time verified emails for prospects using their social media profiles or names and domains (Outbound)

Auto Form Enrichment

Auto enrich form submissions using emails for lead scoring (MQLs)

MQL & Signup Profiling

Find contact profiles behind the MQLs or sign ups both for personal and business emails (PLG)

Event List Enrichment

Enrich partial event and exhibition attendee lists to transform basic contact details into complete, actionable profiles

FAQ

How does Waterfall's pricing work for contact enrichment?

Outcome-based. A credit is deducted only when we return a verified email or a matched profile — never for a request that comes back empty, and never once per vendor we query on the way there. A single request may hit several sources in sequence; you are charged once, for the answer. Rates depend on committed volume and are quoted against your own data rather than a list price: send us 2,000 records your current vendors missed and we will price the actual result.

What is waterfall enrichment, and how does it differ from a single-source database?

A single-source database answers from one vendor's copy of the world: whatever that vendor holds, you get, and whatever it lacks, you do without. Waterfall enrichment queries vendors in sequence and stops at the first verified answer, so coverage is the union of 30+ sources rather than the ceiling of one. The difference shows up on the hard records — non-standard email patterns, smaller companies, and regions outside a given vendor's strength. It is also why cost per result falls as sources are added, while cost per request does not.

Do you verify emails in real time, or serve them from a cache?

In real time, at the moment of your request. Cached email data decays — people leave, domains change, catch-all configurations change — so a database that was accurate when it was built is not accurate when you send. Every email we return is checked before it is returned, which is what keeps bounce rates down on the records you actually mail.

Can I use Waterfall without moving off my current stack?

Yes — that is the point of the design. Waterfall is a data layer, not an application: one schema and one API behind 30+ vendors, called from whatever sits above it. Swapping a source underneath does not change the shape of the response, and leaving does not mean re-integrating. If you already pay two or three vendors directly, the usual first step is to run them alongside Waterfall on the same input file and compare coverage and cost per result.

Book a call to hear more

Every company has different needs. Talk to our team (most likely one of the founders) to share your use case and see how Waterfall can help.