Prospect enrichment

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 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.

Credit usage

Some calls 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	POST /rest/v2/lead_finder/prospects/enrichments	Start an asynchronous enrichment batch for existing prospects.
List prospect enrichments	POST /rest/v2/lead_finder/prospects/enrichments/statuses/query	Query recent prospect enrichment statuses or filter them by email.
Get prospect enrichment	GET /rest/v2/lead_finder/prospects/enrichments/{uuid}	Retrieve one prospect enrichment batch by its returned uuid.