List fill status
Whether a list is still filling after a save or an add, with the people so far and a plain summary. Adds to a list that is still filling wait for their turn and run after it, one after the other. Free.
fill.status is queued (waiting for its turn, with queue_position), processing, done or failed.
| Cost | What it does | Key scopes |
|---|---|---|
| Free | Reads only | argorant:manage_lists |
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
list_id*integer
The list id from create or list.
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/lists/312/fill"JSON
{ "ok": true, "list": { "list_id": 312, "name": "DACH CFOs", "record_type": "person", "selection_mode": "filtered", "filters": { "title": "CFO", "country": "Germany,Austria,Switzerland", "record_type": "person" }, "snapshot_total": 8412, "item_count": 8412, "created_at": "2026-10-07T09:00:00+00:00", "updated_at": "2026-10-07T09:02:10+00:00" }, "fill": { "job_id": 913, "status": "processing", "target_rows": 8412, "inserted_rows": 5120, "scanned_rows": 5120, "error": null }, "filling": true, "summary": "The list is still filling: 5,120 people so far. Check again in a minute."}