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. 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 still running — no results yetJob completed — results and summary populatedJob failed — errors populated, no results

{
    "data": {
        "type": "batch_remove_from_list_job",
        "id": "job_7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "attributes": {
            "status": "running",
            "configuration": {
                "list_id": "contact_456",
                "items": [
                    {
                        "type": "contact",
                        "id": "3170656125"
                    },
                    {
                        "type": "contact",
                        "id": "3219787635"
                    }
                ]
            },
            "created_at": "2026-05-13T12:00:00Z"
        }
    },
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429

🔴500Server Error

🔴504Gateway Timeout