lead-enrichments
Enrich leads with additional contact and company data.
Start a batch lead enrichment
Queues a batch of rows (each needing a LinkedIn URL or an email) for phone-number enrichment via the provider waterfall, billed against the organization balance. Returns immediately with the enrichment session; poll `status` for progress and `exportCSV` or `list`/`get` for results once it finishes.
List lead enrichments
Lists lead enrichment batches for the organization, newest first. Owners/managers additionally see enrichments with `show: false` (e.g. internal LinkedIn-phone lookups) excluded for everyone else.
Get a lead enrichment
Fetches a single lead enrichment batch by ID, including its per-row results.
Delete a lead enrichment
Permanently deletes a lead enrichment batch by ID.
Get a lead enrichment's progress
Reports where a batch enrichment is in its lifecycle: `pending` with a `queue` position/total while it waits behind other batches, `in_progress` with a `progress` completed/total/percent once it's running, or its terminal status (e.g. `completed`/`failed`) with `finishedAt` once done.
Export a lead enrichment to CSV
Streams back a CSV of one enrichment batch, split by whether a phone number was found: `success` rows carry the enrichment result columns, `no_phone` rows are the ones that failed to resolve a number. Columns combine the original upload data, the enrichment result, and LeadHero-managed lead fields.
Enrich a single lead
Runs the standard phone-number enrichment waterfall for one existing lead, by lead ID. For a higher-accuracy (and typically costlier) pass, use `enrichLeadByLeadHighPrecision` instead.
Enrich a single lead with high-precision providers
**Deprecated.** Use `POST /enrich/{organization}/{lead}` instead. Runs the high-precision phone-number enrichment tier for one existing lead, billed at the high-precision rate. Pass `force: true` to re-run it even if the lead already has an enrichment result.
Report a wrong number and look up another one
Marks the lead's current phone number as wrong, records the feedback on the enrichment that produced it, and starts a new lookup that never returns that number again. The first replacement per lead is free and, when nothing else is found, the original lookup is refunded to the organization balance; later replacements are billed at the usual rate.
Get a lead's enrichment status
Fetches the current enrichment result for a single lead (by lead ID) without triggering a new enrichment run.
Enrich leads missing a phone number
Runs the enrichment waterfall for every lead in the organization that is missing a phone number, or only the given `leadIDs` when provided. Returns aggregate counts rather than per-lead results.
Validate
2 items
Find Phone
2 items