Email Endpoints

The Email endpoints provide comprehensive email intelligence capabilities: • **Verify** - Check if an email is valid and deliverable (£0.020/email) • **Batch Verify** - Verify up to 100 emails in one request (£0.015/email) • **Find** - Find someone's email by name and domain (£0.050/request) • **Guess** - Generate probable email patterns (£0.020/request) • **Score** - Quality score a contact (£0.020/request) All endpoints return detailed information about email deliverability, risk factors, and quality metrics.

Verify a single email address. Returns deliverability status and risk indicators. **Endpoint:** `POST /v1/email/verify` **Request:** ```json { "email": "john@company.com" } ``` **Response:** ```json { "success": true, "data": { "email": "john@company.com", "status": "verified", "isValid": true, "isDeliverable": true, "isRisky": false, "isRole": false, "isFree": false, "isDisposable": false }, "usage": { "cost": 0.005, "balanceRemaining": 19.995 } } ``` **Cost:** £0.020 per verification

Verify multiple emails in a single request (up to 100). **Endpoint:** `POST /v1/email/verify/batch` **Request:** ```json { "emails": [ "john@company.com", "jane@example.com", "contact@business.org" ] } ``` **Response:** ```json { "success": true, "data": { "results": [ { "email": "john@company.com", "isValid": true, "status": "verified" }, { "email": "jane@example.com", "isValid": true, "status": "verified" }, { "email": "contact@business.org", "isValid": false, "status": "invalid" } ], "summary": { "total": 3, "valid": 2, "invalid": 1 } } } ``` **Cost:** £0.015 per email (20% discount vs single verification)

Find someone's email address given their name and company domain. **Endpoint:** `POST /v1/email/find` **Request:** ```json { "firstName": "John", "lastName": "Smith", "domain": "company.com" } ``` **Response:** ```json { "success": true, "data": { "email": "john.smith@company.com", "confidence": 95, "verified": true, "sources": ["company_website", "linkedin"] } } ``` **Cost:** £0.050 per find request

Generate probable email patterns based on name and domain. **Endpoint:** `POST /v1/email/guess` **Request:** ```json { "firstName": "John", "lastName": "Smith", "domain": "company.com" } ``` **Response:** ```json { "success": true, "data": { "guesses": [ { "email": "john.smith@company.com", "score": 92 }, { "email": "jsmith@company.com", "score": 85 }, { "email": "john@company.com", "score": 78 }, { "email": "j.smith@company.com", "score": 72 } ] } } ``` **Cost:** £0.020 per guess request (pattern-based, no external lookup)

Get a quality score for a contact's email address. **Endpoint:** `POST /v1/email/score` **Request:** ```json { "email": "john@company.com", "firstName": "John", "lastName": "Smith", "title": "CEO" } ``` **Response:** ```json { "success": true, "data": { "score": 85, "factors": { "emailMatch": 95, "domainAuthority": 80, "titleRelevance": 90, "dataCompleteness": 75 }, "recommendation": "high_priority" } } ``` **Cost:** £0.020 per score request