---
title: "List the block list"
method: GET
path: "/api/v1/blocklist"
tags: ["API Reference"]
---

# List the block list

`GET /api/v1/blocklist`

## Request

- Base URL: `https://revnu.com`
- URL: `https://revnu.com/api/v1/blocklist`
- Auth: HTTP bearer

The do-not-contact entries the send and research gates enforce, newest first.

Requires the `leads:read` scope.

**Response.** `{ "entries": [entry, …], "nextCursor": "…" | null }`. An entry is `{ id, kind, value, reason, source, addedBy, addedAt }`. `kind` is `domain`, `email` or `linkedin`; a `linkedin` value is the profile URL in the form `https://www.linkedin.com/in/<slug>`; `source` says who added it: `customer_import`, `customer` (dashboard), `agent`, `opt_out_reply` (a provider-reported unsubscribe) or `api`.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

{ "entries": [entry, …], "nextCursor": "…" | null }. An entry is { id, kind, value, reason, source, addedBy, addedAt }. kind is domain, email or linkedin; a linkedin value is the profile URL in the form https://www.linkedin.com/in/<slug>; source says who added it: customer_import, customer (dashboar

- object
  - `entries` object[], required
    - `id` string, required
    - `kind` 'domain' | 'email' | 'linkedin', required
    - `value` string, required
    - `reason` string, nullable, required
    - `source` 'agent' | 'api' | 'customer' | 'customer_import' | 'customer_sync' | 'opt_out_reply', required
    - `addedBy` string, nullable, required
    - `addedAt` number, required
  - `nextCursor` string, nullable, required

## Other responses

- `400`: The request is malformed; the error names the problem.
- `401`: Missing, malformed, unknown or revoked token.
- `402`: `setup_pending`: the account hasn't started its trial. Finish setup with `GET /setup`.
- `403`: The token lacks the scope in `requiredScope`.
- `429`: Rate limited.
- `503`: Temporarily unavailable; retry the same call.

---

[API](https://skmtc.dev/revnu/apis/revnu-api.md) · [All operations](https://skmtc.dev/revnu/apis/revnu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/revnu/apis/revnu-api/revisions/52e523c2db61?raw)