---
title: "List blocklist entries"
method: GET
path: "/blocklist"
tags: ["Blocklist"]
---

# List blocklist entries

`GET /blocklist`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/blocklist`
- Auth: HTTP bearer

Returns the suppression entries (blocked domains and email addresses) that apply to the calling key's workspace, newest first. By default that is both lists: the workspace's own entries and the account-wide ones inherited from the main workspace. Narrow with `scope=workspace` or `scope=global`. Each item reports which list it came from.

## Query parameters

- `scope` 'workspace' | 'global' | 'all'
- `search` string
- `limit` integer
- `offset` integer

## Response `200`

OK

- ModelsBlocklistListResponse
  - `items` ModelsBlocklistEntry[]
    - `createdAt` string
    - `domain` string
    - `emailAddress` string: EmailAddress is the blocked address when the entry blocks one address rather than a whole domain.
    - `id` integer
    - `scope` 'workspace' | 'global': Scope is "workspace" for the calling workspace's own entry, "global" for an account-wide one.
    - `workspaceId` integer: WorkspaceId is the workspace the entry is stored on. For a global entry read from a sub-workspace this is the main workspace, not the caller.
  - `totalCount` integer

## Other responses

- `400`: Invalid scope
- `401`: Unauthorized - invalid or missing API key
- `500`: Failed to list entries

---

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