Get Batch Add Tags Job - Leadfeeder API

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

While status is running, summary is omitted. Once status becomes completed, summary carries the outcome counts (including failed_count). On failed, errors describes the failure.

Credit Note: This endpoint does not consume credits.

INFO

Requires the companies:read OAuth2 scope.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Batch add-tags job status retrieved

Bodyapplication/json

Examples

Job still running — no summary yetJob completed — summary populatedAdvanced-search job completedJob failed — errors populated

{
    "data": {
        "type": "batch_add_tags_job",
        "id": "job_550e8400-e29b-41d4-a716-446655440000",
        "attributes": {
            "status": "running",
            "configuration": {
                "tags": [
                    {
                        "type": "tag",
                        "id": "dd11fc370098e78e"
                    },
                    {
                        "type": "tag",
                        "id": "8bb95c4d8e7c5fd2"
                    }
                ],
                "items": [
                    {
                        "type": "company",
                        "id": "159001425"
                    },
                    {
                        "type": "company",
                        "id": "159001426"
                    }
                ]
            },
            "created_at": "2026-05-13T12:00:00Z",
            "completed_at": null
        }
    },
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429

🔴500Server Error

🔴504Gateway Timeout