LEleadfeeder
Lists
v1

Get Batch Add to List Job

Changed on

Retrieve the status of a batch add-to-list job created via POST /v1/lists/batch-add-to-list-jobs.

While status is running, results and summary are omitted. Once status becomes completed, results carries the per-item outcome and summary carries the per-outcome counts (including failed_count) together with list_size_before and list_size_after. A job created from a search selection reports summary counts only — no per-item results. On failed, errors describes the failure.

Jobs are kept for 7 days after creation.

Credit Note: This endpoint does not consume credits.

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

get/v1/lists/batch-add-to-list-jobs/{job_id}

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/lists/batch-add-to-list-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: lists:read

Path parameters

job_idstring required

The unique identifier of the batch add-to-list job.

Query parameters

account_idstring required

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

Response

Batch add-to-list job status retrieved

Example response

{
  "data": {
    "attributes": {
      "completed_at": "2026-05-13T12:00:18Z",
      "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"
          }
        },
        "items": [
          {
            "id": "159001425",
            "type": "company"
          }
        ],
        "list_id": "company_123"
      },
      "created_at": "2026-05-13T12:00:00Z",
      "errors": [
        {
          "code": "job_failed",
          "title": "External contact data provider timeout"
        }
      ],
      "results": [
        {
          "id": "159001425",
          "status": "added",
          "type": "company"
        }
      ],
      "status": "running",
      "summary": {
        "added": 1,
        "already_present": 1,
        "list_size_after": 52,
        "list_size_before": 51
      }
    },
    "id": "job_550e8400-e29b-41d4-a716-446655440000",
    "type": "batch_add_to_list_job"
  },
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes

  • 8e37aaf0ccadRevision changes
    • info

      removed the scope_mismatch enum value from the //// response property for the response status

  • 1344fb600ac2Revision changes
    • breaking

      the ////// response property's minItems was decreased from 1 to 0 for the response status

    • breaking

      the ///////// response property's minItems was decreased from 1 to 0 for the response status