# Prospect enrichment

> **Documentation index**
> Browse the [Woodpecker developer documentation index](https://developers.woodpecker.co/llms.txt) to discover related API references, guides, webhooks, MCP tools, and CLI documentation.

> Use this flow when you **already have prospects in Woodpecker and want to enrich those existing records** with additional data. If you need to find or manage those records first, use the [Prospects](https://developers.woodpecker.co/docs/prospects.md) endpoints.

Use this flow when you **already have prospects in Woodpecker and want to enrich those existing records** with additional data. If you need to find or manage those records first, use the [Prospects](https://developers.woodpecker.co/docs/prospects.md) endpoints.

**Queue prospects by email** and include as much useful context as you have, such as first name, last name, LinkedIn URL, company name, or company website. The submitted email should belong to an existing prospect in the account's main prospect database.

Prospect enrichment is asynchronous. The queue endpoint returns a batch `uuid` and queue status. Use the status query endpoint for recent or email-filtered results, or fetch a specific batch by `uuid` when you want to inspect one job directly.

:::info Credit usage
Some requests in this flow use account credits. For enrichment requests, credits are applied only when enrichment finds data: 1.5 credits for successfully enriching an existing prospect. GET endpoints used to check enrichment status do not use credits.
:::

## Available endpoints

| Endpoint | Method and path | Use it to |
|----------|-----------------|-----------|
| [Queue prospect enrichments](https://developers.woodpecker.co/docs/lead-finder/prospect-enrichment/queue-prospect-enrichments.md) | `POST /rest/v2/lead_finder/prospects/enrichments` | Start an asynchronous enrichment batch for existing prospects. |
| [List prospect enrichments](https://developers.woodpecker.co/docs/lead-finder/prospect-enrichment/list-prospect-enrichments.md) | `POST /rest/v2/lead_finder/prospects/enrichments/statuses/query` | Query recent prospect enrichment statuses or filter them by email. |
| [Get prospect enrichment](https://developers.woodpecker.co/docs/lead-finder/prospect-enrichment/get-prospect-enrichment.md) | `GET /rest/v2/lead_finder/prospects/enrichments/{uuid}` | Retrieve one prospect enrichment batch by its returned `uuid`. |