Get Batch Remove from List Job

Retrieve the status of a batch remove-from-list job created via POST /v1/lists/batch-remove-from-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_after. A job created from an advanced_search selection reports summary counts only — no per-item results. On failed, errors describes the failure.

Credit Note: This endpoint does not consume credits.

INFO

Requires the lists:read OAuth2 scope.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Batch remove-from-list job status retrieved

Bodyapplication/json

Examples

Job completed — results and summary populatedAdvanced-search job completed — summary only, no per-item resultsJob failed — errors populated, no resultsJob still running — no results yet

{
    "data": {
        "attributes": {
            "completed_at": "2026-05-13T12:00:02Z",
            "configuration": {
                "items": [
                    {
                        "id": "3170656125",
                        "type": "contact"
                    },
                    {
                        "id": "3219787635",
                        "type": "contact"
                    }
                ],
                "list_id": "contact_456"
            },
            "created_at": "2026-05-13T12:00:00Z",
            "results": [
                {
                    "id": "3170656125",
                    "status": "removed",
                    "type": "contact"
                },
                {
                    "id": "3219787635",
                    "status": "removed",
                    "type": "contact"
                }
            ],
            "status": "completed",
            "summary": {
                "failed_count": 0,
                "list_size_after": 49,
                "not_found": 0,
                "not_present": 0,
                "removed": 2,
                "scope_mismatch": 0
            }
        },
        "id": "job_7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "type": "batch_remove_from_list_job"
    },
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429

🔴500Server Error

🔴504Gateway Timeout