Skip to main content
With our Enrichments API, you can enrich a contact’s email address and/or mobile phone number asynchronously and track the result.

Lifecycle

Enrichments are queued from Enrich Contact or Bulk Enrich Contacts, which return one or more enrichmentId values. Use the status endpoint to poll each enrichment until it completes.

Status values

StatusDescription
PENDINGThe enrichment is queued and waiting to start.
PROCESSINGThe enrichment is actively being worked on.
COMPLETEDThe enrichment finished; data contains the result.
FAILEDThe enrichment job failed.
TIMED_OUTThe enrichment got stuck processing; submit a new enrichment.
EXPIREDThe enrichment previously completed, but its charge-dedup window has since lapsed; submit a new enrichment to refresh it.

Authorization

The Public API token is team-scoped. You can only track enrichments that belong to your team; requesting one from another team returns 404.