> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizzy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

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](/api-reference/v2/company/contactEnrich) or
[Bulk Enrich Contacts](/api-reference/v2/company/contactEnrichBulk), which return one or more
`enrichmentId` values. Use the [status](/api-reference/v2/enrichments/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`.