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 completed — summary populatedAdvanced-search job completedJob failed — errors populatedJob still running — no summary yet

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

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429

🔴500Server Error

🔴504Gateway Timeout