Introduction - Bizzy Public API

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

Status	Description
`PENDING`	The enrichment is queued and waiting to start.
`PROCESSING`	The enrichment is actively being worked on.
`COMPLETED`	The enrichment finished; `data` contains the result.
`FAILED`	The enrichment job failed.
`TIMED_OUT`	The enrichment got stuck processing; submit a new enrichment.
`EXPIRED`	The 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.