Create Company Enrichment Job

POST

/v1/companies/enrichment-jobs

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.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Query Params

Body Params application/jsonRequired

Example

{
    "data": {
        "type": "enrichment_job",
        "attributes": {
            "company_ids": [
                "651713",
                "467823"
            ],
            "custom_field_id": "ai_account_score",
            "enrichment_strategy": "missing_values"
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.leadfeeder.com/v1/companies/enrichment-jobs?account_id=123456' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "type": "enrichment_job",
        "attributes": {
            "company_ids": [
                "651713",
                "467823"
            ],
            "custom_field_id": "ai_account_score",
            "enrichment_strategy": "missing_values"
        }
    }
}'

Responses

🟢202Accepted

application/json

Job accepted and started

Bodyapplication/json

Example

{
    "data": {
        "type": "enrichment_job",
        "id": "job_21662",
        "attributes": {
            "status": "running",
            "created_at": "2026-03-10T12:00:00Z"
        }
    },
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠422Parameter Error

🟠429Server Error

🔴500Server Error

Modified at 2026-06-30 11:47:49

Estimate Company Enrichment Job

Get Company Enrichment Job Status