ArgorantDocs

Follow a large block

gethttps://app.argorant.com/api/v1/blocklist/jobs/{job_id}
GET
/api/v1/blocklist/jobs/{job_id}

Progress of a bulk block or of a dry run that needed more time. status is queued, running, done or failed; leads_suppressed (or leads_to_stop for a dry run) grows as it works.

CostWhat it doesKey scopes
FreeReads onlyargorant:read_counts

Authorization

BearerAuth
AuthorizationBearer <token>

Your API key from app.argorant.com/profile, sent as Authorization: Bearer <key>. A connector sign-in token (ag_mcp_...) works the same way.

In: header

Path Parameters

job_id*string

The job_id from POST /api/v1/blocklist/bulk.

Formatuuid

Header Parameters

X-Request-Id?string

Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.

Match^[A-Za-z0-9._-]{8,64}$

Response Body

application/json

application/json

application/json

application/json

application/json

Shell
curl -X GET "https://app.argorant.com/api/v1/blocklist/jobs/5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716"
JSON
{  "job_id": "5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716",  "kind": "add",  "status": "done",  "values": 4200,  "scope": "workspace",  "added": 4160,  "already_listed": 40,  "leads_suppressed": 912,  "progress_percent": 100,  "created_at": "2026-10-21T15:20:00+00:00",  "finished_at": "2026-10-21T15:21:10+00:00",  "summary": "Added 4,160; 40 were already listed. Stopped 912 campaign leads."}