v3

OpenAPI 3.1.1mit2026-07-3165481.5 MB
Companies
Enrichment
v1

Get Company Enrichment Job Status

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.

:::info Requires the companies:read OAuth2 scope. :::

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

Path parameters

job_idstring required

The unique identifier of the enrichment job

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

Response

Job status retrieved

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"
  }
}