LEleadfeeder
Companies
Enrichment
v1

Get Company Enrichment Job Status

Changed on

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. :::

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

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/companies/enrichment-jobs/{job_id}
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization code: https://api.leadfeeder.com/v1/oauth/authorize
      Token URL: https://api.leadfeeder.com/v1/oauth/token scopes: companies:read

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": {
    "attributes": {
      "completed_at": "2026-03-10T12:05:30Z",
      "configuration": {
        "advanced_search": {
          "excluded_company_ids": [
            "651713"
          ],
          "filters": {
            "items": [
              {
                "field": "country_code",
                "operator": "in",
                "type": "filter",
                "value": [
                  "DE"
                ]
              },
              {
                "field": "employee_count",
                "operator": "in_range",
                "type": "filter",
                "value": {
                  "gte": 50
                }
              }
            ],
            "operator": "and",
            "type": "group"
          },
          "page": {
            "size": 1000
          },
          "sort": {
            "direction": "desc",
            "field": "employee_count"
          }
        },
        "enrichment_strategy": "missing_values"
      },
      "created_at": "2026-03-10T12:00:00Z",
      "credits": {
        "consumed": 0.3,
        "estimated": 0.6
      },
      "errors": [
        {
          "code": "job_failed",
          "title": "External contact data provider timeout"
        }
      ],
      "results": [
        {
          "company_id": "651713",
          "company_name": "Acme GmbH",
          "contacts": [
            {
              "attributes": {
                "full_name": "Jane Doe",
                "position": {
                  "title": "Head of Procurement"
                }
              },
              "id": "435834",
              "type": "contact_preview"
            },
            {
              "attributes": {
                "full_name": "John Smith",
                "position": null
              },
              "id": "435901",
              "type": "contact_preview"
            }
          ],
          "outcome": "success",
          "reason": "Fits the target profile",
          "score": 8
        }
      ],
      "status": "running"
    },
    "id": "job_21662",
    "type": "enrichment_job"
  },
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes

  • 686d4e39eb05Revision changes
    • info

      added the optional property /// to the response with the status

  • cfe89c1fc59dRevision changes
    • breaking

      the /// response's property type changed from integer to number for status