Companies
Enrichment
v1
Create Company Enrichment Job
Trigger an asynchronous job to enrich companies with AI-generated custom field values. The custom field must exist and be of an AI type (ai_score, ai_text, ai_number, ai_boolean). Create custom fields via the Custom Fields API first. The job runs in the background; poll the status endpoint to check progress. A maximum of 50,000 companies are enriched per job, whether targeted via company_ids or list_id; companies beyond this limit are not processed. Split larger selections across multiple jobs. Credit Note: Credits are consumed as companies are enriched.
:::info Requires the companies:read OAuth2 scope. :::
post/v1/companies/enrichment-jobs
Query parameters
account_idstring required
The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
Request body
Response
Job accepted and started
Example response
{
"data": {
"type": "enrichment_job",
"id": "job_21662",
"attributes": {
"status": "running",
"configuration": {
"enrichment_strategy": "missing_values"
},
"errors": [
{
"code": "job_failed",
"title": "External contact data provider timeout"
}
],
"created_at": "2026-03-10T12:00:00Z",
"completed_at": "2026-03-10T12:05:30Z"
}
},
"meta": {
"request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
}
}