Enrichment Endpoints

The Enrichment endpoints provide comprehensive data enhancement: • **Contact Enrichment** - Find and verify an email for a person (£0.080/request) • **Company Enrichment** - Get all contacts for a company domain (£0.25/request) Enrichment combines multiple data sources and verification steps to deliver high-quality, verified contact data for your sales and marketing workflows.

Enrich a single contact with verified email and additional data. **Endpoint:** `POST /v1/enrich/contact` **Request:** ```json { "firstName": "John", "lastName": "Smith", "domain": "company.com", "title": "CEO" } ``` **Response:** ```json { "success": true, "data": { "firstName": "John", "lastName": "Smith", "email": "john.smith@company.com", "verified": true, "title": "CEO", "qualityScore": 92, "sources": ["pattern_match", "verification"], "enrichedAt": "2026-02-27T12:00:00Z" }, "usage": { "cost": 0.08, "balanceRemaining": 19.92 } } ``` **Cost:** £0.080 per contact The enrichment pipeline: 1. Pattern-based email guessing (free) 2. Paid email finding if patterns don't match 3. Email verification of the found address

Get all contacts for a company domain. **Endpoint:** `POST /v1/enrich/company` **Request:** ```json { "domain": "company.com", "limit": 10 } ``` **Response:** ```json { "success": true, "data": { "companyName": "Company Inc", "domain": "company.com", "contacts": [ { "email": "john.smith@company.com", "firstName": "John", "lastName": "Smith", "title": "CEO", "verified": true, "qualityScore": 92 }, { "email": "jane.doe@company.com", "firstName": "Jane", "lastName": "Doe", "title": "CTO", "verified": true, "qualityScore": 88 } ], "totalContacts": 12, "verifiedContacts": 10 }, "usage": { "cost": 0.25, "balanceRemaining": 19.75 } } ``` **Cost:** £0.25 per company

Our enrichment process follows a cost-optimized pipeline: 1. **Pattern Guessing** (Free) - Generate likely email patterns based on name and domain 2. **Pattern Verification** (£0.020) - Verify the most likely pattern 3. **Paid Finding** (£0.050, if needed) - If patterns don't verify, use paid sources 4. **Final Verification** (£0.020) - Verify any found email This approach minimizes costs while maximizing accuracy. Most contacts are resolved through pattern matching, with paid finding only used when necessary. **Quality Score:** Each contact receives a quality score (0-100) based on: • Email verification status • Domain authority • Data completeness • Source reliability