Get Company Enrichment Job Status

GET

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

Retrieve the current status of a Company AI Enrichment job, with any errors. credits.estimated is set when the job is created if it targets company_ids, and otherwise once the job has found the companies to enrich. credits.consumed is reported once the job has finished. The counts in summary can appear shortly before status changes.
Jobs are kept for 7 days after creation. A job that stops unexpectedly can stay running until then.
Credit Note: This endpoint does not consume credits.

INFO

Requires the companies:read OAuth2 scope.

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

Examples

Job completed, with its counts and the credits consumedJob failed, the search took too longJob still running, its companies found but no counts yet

{
    "data": {
        "attributes": {
            "completed_at": "2026-03-10T12:05:30Z",
            "configuration": {
                "custom_field_id": "ai_account_score",
                "enrichment_strategy": "all",
                "list_id": "company_12345"
            },
            "created_at": "2026-03-10T12:00:00Z",
            "credits": {
                "consumed": 238,
                "estimated": 250
            },
            "status": "completed",
            "summary": {
                "failed": 12,
                "succeeded": 238,
                "total": 250
            }
        },
        "id": "job_21662",
        "type": "enrichment_job"
    },
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429Server Error

🔴500Server Error

Modified at 2026-11-04 10:25:34

Estimate Company Enrichment Job

Retrieve Company IPs