Get Company Enrichment Job Status

GET

/v1/companies/enrichment-jobs/{job_id}

Retrieve the current status of a Company AI Enrichment job. Returns progress counters, credit consumption, and any errors.
Jobs are retained for 7 days after completion.
Credit Note: This endpoint does not consume credits.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

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

Path Params

Query Params

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/job_21662?account_id=123456' \
--header 'X-Api-Key: <api-key>'

Responses

🟢200OK

application/json

Job status retrieved

Bodyapplication/json

Example

{
    "data": {
        "type": "enrichment_job",
        "id": "job_21662",
        "attributes": {
            "status": "completed",
            "configuration": {
                "company_ids": [
                    "651713",
                    "467823"
                ],
                "custom_field_id": "ai_account_score",
                "enrichment_strategy": "missing_values"
            },
            "credits": {
                "estimated": 100,
                "consumed": 82
            },
            "summary": {
                "total": 100,
                "succeeded": 82,
                "failed": 18
            },
            "created_at": "2026-03-10T12:00:00Z",
            "completed_at": "2026-03-10T12:05:30Z"
        }
    },
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠403Forbidden

🟠404Record Not Found

🟠429

🔴500Server Error

Modified at 2026-05-18 11:47:40

Create Company Enrichment Job

Get Contact Details