SyncGTM now works inside Claude and ChatGPT. Learn more
REST API

Waterfall enrichment API: maximum email and phone coverage in one call

Waterfall through 10+ data providers on a single request — work emails, personal emails, mobile numbers, and email verification without juggling multiple vendor contracts. Send a LinkedIn URL, get clean JSON back, and pay only when we find the data.
POST /enrich/work-email
curl https://api.syncgtm.com/v1/api/enrich/work-email \
  -H "Authorization: Bearer $SYNCGTM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Jane", "last_name": "Doe", "domain": "stripe.com"}'
200 OK
{
  "status": "found",
  "data": { "email": "jane@stripe.com" }
}

1 credit charged

not_found returns data: null and costs 0 credits

Endpoints

Four waterfall enrichment endpoints, priced per answer

One POST, one JSON body, one answer. Find endpoints only charge when they return data — misses are on us.

POST/enrich/work-email

Find Work Email

1 credit per email found

Input
linkedin_url, or first_name + last_name + domain
Returns
data.email

Reach buyers in the inbox they work from. Send a LinkedIn URL and a domain together to unlock more providers.

Endpoint reference
POST/enrich/personal-email

Find Personal Email

3 credits per email found

Input
linkedin_url
Returns
data.email (Gmail, Outlook, iCloud…)

Reach people who just changed jobs or ignore their work inbox. Company addresses are filtered out, so you never pay 3 credits for a work email.

Endpoint reference
POST/enrich/mobile

Find Mobile Number

10 credits per number found

Input
linkedin_url
Returns
data.phone

A direct line to the decision maker. Save it for the accounts your reps will actually call.

Endpoint reference
POST/enrich/verify-email

Verify Email

0.2 credits per email

Input
email
Returns
Verified or Unverified

Protect your sender reputation. Check deliverability before an address enters a sequence — malformed addresses are rejected free.

Endpoint reference

POST /enrich/work-email

{ "linkedin_url": "…/in/janedoe", "domain": "stripe.com" }

FindymailFindymail
No match
Datagma
No match
CrustdataCrustdata
jane@stripe.com
Forager
Not called
DropleadsDropleads
Not called
200 · status: "found"Charged once: 1 credit
Waterfall enrichment

Get the highest email and phone coverage from one endpoint

Waterfall through 10+ data providers on a single request. If one misses, the next picks it up — no vendor contracts to sign, no fallback logic to maintain, no response formats to normalize.

One integration, maximum hit rate, so you never miss another deal. You pay once per lookup, never once per provider tried.

  • More coverage than any single data provider
  • Send a LinkedIn URL and a domain to unlock more providers
  • Personal-email lookups skip company addresses automatically
  • Same waterfall as the SyncGTM app and MCP server

Credit usage

Last 6 requests

  • /enrich/work-email

    found

    1
  • /enrich/work-email

    not_found

    free0
  • /enrich/mobile

    504 timeout

    refunded0
  • /enrich/mobile

    found

    10
  • /enrich/mobile

    same Idempotency-Key

    replayed0
  • /enrich/verify-email

    Verified

    0.2
3 of 6 requests free11.2 credits total
Pay per answer

Pay for the data you get, not the lookups that miss

Most data APIs charge per request, so empty results and dropped connections eat your budget. With SyncGTM, a miss returns data: null and costs zero. Timeouts are refunded.

Retrying? Send an Idempotency-Key and you get the original answer back for 24 hours — never charged twice for the same mobile number.

  • Misses are free on every find endpoint
  • Timeouts refund every credit held for the lookup
  • Idempotent retries for 24 hours
  • One credit balance across the app, MCP, and API
Use cases

What teams build on the waterfall enrichment API

Wire enrichment into the systems you already run — webhooks, cron jobs, scripts. No tables, no tab-switching.

Enrich every signup instantly

Your form captures a name and company domain. A webhook finds and verifies the work email before the lead hits your CRM — reps never open a half-empty record.

Keep your CRM fresh on autopilot

A nightly job finds contacts missing an email or phone, enriches them, and writes the answers back. Skip records that already have data — filtering is free.

Enrich a whole list from a script

Loop through a CSV of LinkedIn URLs at one request a second and write each answer to a new column. No exports, no copy-pasting between tabs.

Stop bounces before they start

Run verify-email across any list for 0.2 credits an address and push only Verified contacts to your sequencer. Your sender reputation stays intact.

Your first lookup in 3 steps

01

Create a key in Settings → API keys. Owners and admins can create keys, and each one is shown once.

02

Send a POST to /v1/api/enrich/work-email with a LinkedIn URL and your key as a Bearer token.

03

Read the JSON: status found with the email in data, or not_found at no cost.

API or MCP?

Pick by who's making the call

Same lookups, same providers, same credit prices, one balance.

Enrichment API

A program is making the call.

  • Nightly CRM syncs, signup webhooks, scripts over a CSV
  • Fixed JSON and HTTP status codes you can branch on
  • Four high-volume contact lookups today
  • API key, sent as a Bearer token

Enrichment MCP

A person is asking.

  • Claude, ChatGPT, Cursor, and any MCP client
  • The assistant picks and chains actions for you
  • Every enrichment, signal, and research action
  • Browser sign-in, no key to store
Explore the Enrichment MCP

Frequently Asked Questions

What is a waterfall enrichment API?

Why use a waterfall instead of a single data provider?

Which endpoints are available?

How does billing work?

How do I get an API key?

Is there a batch endpoint?

What are the rate limits?

What if a lookup times out?

How is the API different from the SyncGTM MCP server?

Does work-email check that the address is deliverable?

Can I call the API from a browser or mobile app?

Question not answered above? Contact us here

Ready to plug 10+ data providers into your stack?

Get your API key, send one POST, and read the JSON. One integration, maximum hit rate — and misses are free.