Enrichment & Verification API
Enrichment endpoints look up additional context for an email/phone/domain (Apollo, Clearbit, Hunter, plus internal sources). Verification endpoints validate deliverability.
Person & Company
| Method | Path | Description |
|---|---|---|
| POST | `/api/v1/enrichment/person` | Enrich a person |
| POST | `/api/v1/enrichment/company` | Enrich a company |
| POST | `/api/v1/enrichment/contact/:id` | Enrich an existing CRM contact |
| POST | `/api/v1/enrichment/auto-enrich/toggle` | Toggle auto-enrich for new contacts |
Verification
| Method | Path | Description |
|---|---|---|
| POST | `/api/v1/verify/email` | Email deliverability check |
| POST | `/api/v1/verify/phone` | Phone validation + carrier lookup |
| POST | `/api/v1/verify/company` | Company domain liveness |
Bulk
| Method | Path | Description |
|---|---|---|
| POST | `/api/v1/enrichment/bulk` | Submit a bulk job |
| GET | `/api/v1/enrichment/bulk/:jobId/status` | Poll progress |
Every response uses the standard envelope:
{
"success": true,
"data": { /* resource or array */ },
"meta": { "total": 100, "cursor": "...", "hasMore": true },
"error": { "code": "ERROR_CODE", "message": "Human readable" }
}error is omitted on success; meta is omitted when not paginating.
Rate Limits
Subject to the standard 200 req/min/tenant authenticated limit. See [Rate Limits](/docs/api-reference/rate-limits) for full details and the per-endpoint overrides.