Phone Enrichment API

Find phone numbers that convert

Reach decision-makers on mobile — not landlines, not reception desks

Input type

You Input

curl --request POST \
  --url https://api.waterfall.io/v1/enrichment/phone \
  --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/phone?job_id={job_id}
{
  "status": "SUCCEEDED",
  "output": {
    "person": {
      "first_name": "Jane",
      "last_name": "Doe",
      "mobile_phone": "+14155550123",
      "phone_numbers": ["+14155550123"],
      "title": "Head of Sales",
      "company_name": "Acme Corp",
      "company_domain": "acme.com"
    }
  }
}

You Input

curl --request POST \
  --url https://api.waterfall.io/v1/enrichment/phone \
  --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/phone?job_id={job_id}
{
  "status": "SUCCEEDED",
  "output": {
    "person": {
      "first_name": "Jane",
      "last_name": "Doe",
      "linkedin_url": "https://www.linkedin.com/in/jane-doe-abc123/",
      "mobile_phone": "+14155550123",
      "phone_numbers": ["+14155550123"],
      "title": "Head of Sales",
      "company_name": "Acme Corp"
    }
  }
}

You Input

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

Your Receive

// GET /v1/enrichment/phone?job_id={job_id}
{
  "status": "SUCCEEDED",
  "output": {
    "person": {
      "first_name": "Jane",
      "last_name": "Doe",
      "professional_email": "jane.doe@acme.com",
      "mobile_phone": "+14155550123",
      "phone_numbers": ["+14155550123"],
      "title": "Head of Sales",
      "location": "San Francisco, California, United States"
    }
  }
}

Methodology

What makes Waterfall different

Exclusively Mobile Numbers

Quality

Get actual mobile numbers, not landlines, reception desks, or general office numbers.

Unmatched Data Coverage from 30+ Sources

Coverage

Whether you need global reach across different regions or reliable information for non-standard email patterns, our extensive network ensures you get the data others miss.

Connect-Rate Optimized Phone Data

Accuracy

We understand every conversation matters for your reps. That's why we prioritize the highest accuracy vendors in our mix. We quarterly benchmark vendors on real disposition data and rerank them to maximize connect rates, not cost or a blind match rate.

Pay Only for Accurate Results.

Pricing

We offer outcome-based pricing — Waterfall deducts credits only when we return a mobile number, even though we incur costs querying our vendors on every request. Misses are free, and one credit covers the whole waterfall however many sources it takes. Because we rerank vendors on real disposition data rather than on list price, what you are buying is cost per connect, not cost per record.

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 Phone Enrichment API

Mobile Number Discovery

Find mobile numbers for outbound prospecting using emails, social profiles, or name and company details

CRM Phone Enrichment

Auto enrich missing phone fields in your CRM to improve data completeness and connect rates

Ad Audience Building

Create custom audiences for social media and digital advertising by enriching your lists with mobile numbers

FAQ

How does pricing work for phone enrichment?

Outcome-based. A credit is deducted only when we return a mobile number — not for empty results, and not once per vendor queried. Rates depend on committed volume and are quoted against your own data. The comparison worth making is not price per record but cost per connect: a cheap number nobody answers costs more than an expensive one that reaches the person. Send us 2,000 records your current vendors missed and we will price the result.

Do you return mobile numbers or switchboard lines?

Mobile numbers. Landlines, reception desks and general office lines are filtered out rather than counted as matches, because a rep dialling a switchboard has not reached anyone. This lowers our headline match rate against vendors that count any number as a hit, and raises conversations per hour — which is the metric that actually pays for the data.

How do you decide which vendor to use for a given record?

We benchmark vendors quarterly against real disposition data — what happened when the number was actually dialled — and rerank the waterfall on connect rate rather than on price or on self-reported match rate. Vendors that degrade fall down the order; vendors that are strong in a particular region or segment rise for those records. You inherit that reranking without changing a line of your integration.

What inputs can I send?

An email, a social profile URL, or a name plus company domain. You do not need one consistent identifier across the file — the API resolves from whichever you have, which matters when the list came from a form, an event or an export rather than a clean CRM.

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.