API Reference / List the block list
List the block list
GET/api/v1/blocklist
The do-not-contact entries the send and research gates enforce, newest first.
curl -H "Authorization: Bearer $REVNU_API_TOKEN" "https://revnu.com/api/v1/blocklist?limit=50"Query
| Parameter | Meaning |
|---|---|
limit |
Rows per page, 1 to 200. Default 50. |
cursor |
The nextCursor from the previous page. |
Response
{ "entries": [entry, …], "nextCursor": "…" | null }. An entry is { id, kind, value, reason, source, addedBy, addedAt }. kind is domain or email; source says who added it: customer_import, customer (dashboard), agent, opt_out_reply (a provider-reported unsubscribe) or api.
Agents: this page is also markdown at /docs/blocklist.md, answers Accept: text/markdown, and is listed in /docs/llms.txt.
Frequently Asked Questions
A domain blocks every person at that company and at its subdomains. An email blocks one mailbox. Both apply to first touches: the send path refuses, and research skips the company before spending anything.