By Jean-Luc Manceron, Co-founder & CTO at FullEnrich — owns the API infrastructure that powers waterfall enrichment.

What Is a Data Enrichment API?

A data enrichment API is a programmatic interface that takes partial contact or company records — a name, an email, a domain — and returns verified, structured data: work email, mobile number, job title, company size, tech stack, and more. Unlike UI-based enrichment tools where you upload a CSV and wait, an API enriches records in real time as they flow through your system — on form submit, CRM update, or webhook trigger.

The difference matters at scale. A UI tool works for 500-person lists. An API works for 50,000 leads per day, embedded in your pipeline, running without human intervention.

REST vs Webhook: Two Integration Patterns

Most enrichment APIs support two patterns:

Synchronous (REST)

Send a request, wait for the response. Simple, predictable, but slower for batch jobs. Best for single-record enrichment — a form submission, a Slack command, an AI agent tool call.

curl -X POST https://api.fullenrich.com/v2/enrich \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Jane", "last_name": "Doe", "company": "Acme Corp"}'

Response includes verified email, mobile, job title, company data, and the source that hit — in under 3 seconds for cached records, 10–30 seconds for waterfall lookups.

Asynchronous (Webhook)

Send a batch of records, get results pushed to your endpoint when they're ready. Best for large lists — 1,000+ records — where you don't want to hold a connection open. FullEnrich sends a webhook payload to your callback URL with each enriched record.

Authentication & Rate Limiting

FullEnrich's API uses Bearer token authentication. Your API key lives in the dashboard under Settings → API. Rate limits:

• Single enrichment: 10 requests/second
• Batch enrichment: 1,000 records per request, 5 concurrent batches
• Webhook delivery: Retries 3x with exponential backoff on failure

If you need higher throughput, the Enterprise plan unlocks custom rate limits and dedicated infrastructure.

Batch vs Single-Record Enrichment

Error Handling

The API returns structured error responses with HTTP status codes:

• 200 — Enrichment successful
• 202 — Batch accepted, processing async
• 404 — No match found (no credit charged)
• 429 — Rate limit exceeded (retry after header)
• 500 — Server error (retry with backoff)

Critical: a 404 means the waterfall exhausted all 20+ sources and found no verified match. You're not charged for this — credits are only consumed on verified hits.

The MCP Protocol: AI-Native Enrichment

Beyond REST, FullEnrich supports the Model Context Protocol (MCP) — a standard that lets AI agents call enrichment as a tool. Instead of your code calling the API, your AI agent decides when to enrich, what to enrich, and how to use the result. This is how companies like 11x went from 200M to 1.6B reachable contacts.

MCP turns enrichment from a pipeline step into an autonomous capability. The agent enriches, qualifies, and routes — all in one conversation.

When to Use the API vs the UI

• Use the API when enrichment needs to happen automatically — form submissions, CRM triggers, nightly backfills, AI agent workflows
• Use the UI when you're doing one-off list enrichment — a conference attendee list, a Sales Navigator export, a quick prospecting session
• Use both when your team mixes manual prospecting with automated pipeline enrichment

Related Resources

• Email Enrichment — the managed waterfall for list-level enrichment
• Email Finder — single-lookup and bulk email finding
• Waterfall Enrichment — how the cascade works under the hood
• FullEnrich MCP — AI-native data infrastructure
• Waterfall Enrichment Guide — the complete technical breakdown

Frequently Asked Questions

What is a data enrichment API?

A data enrichment API is a programmatic interface that takes partial records (name, email, domain) and returns verified, structured data — work email, phone, job title, company info. It runs in real time as part of your pipeline, unlike UI tools that require manual uploads.

How do I integrate data enrichment into my CRM?

Most teams use Zapier, Make, or n8n to trigger enrichment on new CRM records. FullEnrich also has native HubSpot and Salesforce integrations. For custom workflows, use the REST API with webhook delivery to push enriched data back into your CRM automatically.

What is the difference between API and CSV enrichment?

CSV enrichment is batch and manual — upload a file, wait, download results. API enrichment is programmatic and real-time — your system sends records as they appear and gets results back automatically. The API is for pipelines; CSVs are for one-off lists.

How much does a data enrichment API cost?

FullEnrich starts at $29/mo for 500 credits. You pay per verified match — failed lookups cost nothing. Credits roll over up to 3 months. The API is available on all plans with no additional per-call fees.