List blocked addresses and domains
Addresses and domains your campaigns never contact, newest first, 50 per page by default and at most 1,000. Follow next_cursor for the next page; total and counts cover the whole list. q finds entries that contain a text. A block covers every campaign of the workspace (scope: workspace) or only one campaign (scope: campaign with its campaign_id). campaign_id lists what applies to that campaign: its own blocks plus the workspace ones, or only its own with scope=campaign. fields=compact returns only value, type, scope, campaign_id and created_at.
| Cost | What it does | Key scopes |
|---|---|---|
| Free | Reads only | argorant:read_counts |
Authorization
BearerAuth 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
Query Parameters
Entries per page, 1 to 1,000 (default 50). A larger value returns 1,000.
1 <= value <= 100050The next_cursor of the previous page. Leave out for the first page.
Rows to skip, as an alternative to cursor.
0 <= value0Only entries whose value or reason contains this text (up to 200 characters).
Only addresses or only domains.
Value in
- "email"
- "domain"
all (default), workspace or campaign.
"all"Value in
- "all"
- "workspace"
- "campaign"
What applies to this campaign.
uuidfull (default) or compact.
"full"Value in
- "full"
- "compact"
Header Parameters
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.
^[A-Za-z0-9._-]{8,64}$Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://app.argorant.com/api/v1/blocklist?limit=50&q=acme"{ "entries": [ { "id": "c9a94730-604c-4156-bee1-d52e24a3f847", "value": "competitor.com", "type": "domain", "scope": "workspace", "created_at": "2026-09-19T12:54:32+00:00", "reason": "customer", "yours": true }, { "id": "0b6f3f2e-1d4c-4a5b-9c8d-7e6f5a4b3c2d", "value": "jane@acme.com", "type": "email", "scope": "campaign", "campaign_id": "7f3a2c1e-9b4d-4e8a-a1c2-5d6e7f8a9b0c", "created_at": "2026-10-21T09:12:00+00:00", "reason": "manual", "yours": true, "campaign_name": "Q4 CFO outreach" } ], "total": 383, "limit": 50, "offset": 0, "next_cursor": "bzo1MA", "has_more": true, "counts": { "workspace": 380, "campaign": 3, "email": 300, "domain": 83 }}