REST: list endpoints - Argorant Help

A saved list stores a filter set, not a frozen snapshot. Re-open it later and it reflects the current market. Creating one is free and reveals nothing: the server counts the matches itself, so the list reports its real size immediately.

Create

curl -X POST -H "Authorization: Bearer ag_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "DACH CFOs 200+", "filters": {"title": "CFO", "country": "DACH"}, "record_type": "person", "selection_mode": "filtered"}' \
  https://argorant.com/api/mcp/lists/create

The response carries the new list id, its name and the snapshot total, which is how many contacts currently match.

Status

GET /api/mcp/lists/{list_id}

Returns the list name, its current size, its selection mode and its record type. The id is numeric, so validate it before calling if it came from user input.

List creation response showing the list id and its match count

CLI equivalent

npx argorant list create --name "DACH CFOs 200+" --title CFO --country DACH
npx argorant list status 42

The pattern that works: keep one list per segment, check its size on a schedule to watch a market move, and export a fresh slice whenever a campaign starts. Because the list is a filter set, the export always reflects the market as it is today, including new companies and executives who have moved.