Skip to content

Bulk Enrich

POST
/api/leads/bulk-enrich
curl --request POST \
--url http://localhost:8000/api/leads/bulk-enrich \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "action": "find_emails", "lead_ids": [ 1 ] }'

Enrich a batch of leads in the background; returns a job_id immediately.

Reuses the batchable enrichment services (email_finder / website_scraper). Capped at 100 leads per call so a huge selection can’t hammer providers. Progress streams over ProgressBus (/api/events) keyed by job_id.

x-workspace-id
Any of:
string
Media typeapplication/json
BulkEnrichBody
object
action
Action
string
default: find_emails
lead_ids
required
Lead Ids
Array<integer>

Successful Response

Media typeapplication/json
Examplegenerated
example

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
"detail": [
{
"ctx": {},
"input": "example",
"loc": [
"example"
],
"msg": "example",
"type": "example"
}
]
}