Blocklist

List blocklist entries

get

Returns the workspace suppression list (blocked domains and email addresses), newest first.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Query parameters

limitintegerOptional

Page size (default 100, max 1000)

offsetintegerOptional

Offset (default 0)

Header parameters

AuthorizationstringRequired

Bearer <API_KEY>

Responses

200

OK

application/json

totalCountintegerOptionalExample: 214

401

Unauthorized - invalid or missing API key

application/json

500

Failed to list entries

application/json

get/blocklist

HTTPcURLJavaScriptPython

GET /r/blocklist HTTP/1.1
Host: api.emailchaser.com
Authorization: text
Accept: */*

{
  "items": [
    {
      "createdAt": "text",
      "domain": "competitor.com",
      "emailAddress": "[e-mail]",
      "id": 17
    }
  ],
  "totalCount": 214
}

Add blocklist entries

post

Adds up to 1000 suppression entries in one call. Each value is either a full email address (contains "@") or a bare domain. Existing entries and invalid values are skipped, so the call is safe to retry and suited to carrying over a suppression list from another sending platform.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Header parameters

AuthorizationstringRequired

Bearer <API_KEY>

Body

application/json

valuesstring[]Required

Values holds the email addresses and/or domains to block, up to 1000 per request.

Example: ["competitor.com","[e-mail]"]

Responses

200

OK

application/json

createdintegerOptional

Created is the number of new suppression entries written.

Example: 42

skippedintegerOptional

Skipped is the number of values ignored because they already existed or failed validation.

Example: 3

400

Invalid request body

application/json

401

Unauthorized - invalid or missing API key

application/json

500

Failed to add entries

application/json

post/blocklist

HTTPcURLJavaScriptPython

POST /r/blocklist HTTP/1.1
Host: api.emailchaser.com
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "values": [
    "competitor.com",
    "[e-mail]"
  ]
}

{
  "created": 42,
  "skipped": 3
}