Suppressions API

Base URL: https://mail.axene.io/v1

All endpoints require authentication via API Key or JWT cookie. API keys use the axm_k_ prefix.

Using an official SDK? The suppressions resource wraps these endpoints. Guides: TypeScript, Python, Go, PHP, Ruby, Rust, Java, .NET, Swift.

List suppressions

GET /v1/suppressions

Returns a paginated list of suppressed email addresses.

Query parameters:

Parameter	Type	Default	Description
`page`	integer	0	Page number (zero-indexed).
`limit`	integer	50	Results per page (max 200).
`search`	string	--	Filter by email address substring.

cURL:

curl "https://mail.axene.io/v1/suppressions?page=0&limit=50&search=example.com" \
  -H "Authorization: Bearer axm_k_YOUR_API_KEY"

Python:

import requests
 
response = requests.get(
    "https://mail.axene.io/v1/suppressions",
    params={"page": 0, "limit": 50, "search": "example.com"},
    headers={"Authorization": "Bearer axm_k_YOUR_API_KEY"},
)
print(response.json())

Node.js:

const response = await fetch(
  "https://mail.axene.io/v1/suppressions?page=0&limit=50&search=example.com",
  {
    headers: { Authorization: "Bearer axm_k_YOUR_API_KEY" },
  }
);
const data = await response.json();

Response:

{
  "items": [
    {
      "id": "sup_abc123",
      "email_address": "[email protected]",
      "reason": "bounce",
      "created_at": "2026-04-06T10:00:00Z",
      "blocked_attempts": 1,
      "last_blocked_at": "2026-04-06T10:00:00Z",
      "override_used_at": null
    },
    {
      "id": "sup_def456",
      "email_address": "[email protected]",
      "reason": "complaint",
      "created_at": "2026-04-05T14:30:00Z",
      "blocked_attempts": 1,
      "last_blocked_at": "2026-04-05T09:00:00Z",
      "override_used_at": "2026-04-05T14:30:00Z"
    }
  ],
  "total": 2,
  "page": 0,
  "limit": 50
}

blocked_attempts, last_blocked_at, and override_used_at reflect the one-time retry override described in Sending to a suppressed recipient:

Field	Description
`blocked_attempts`	How many times a send to this address has been rejected.
`last_blocked_at`	When the most recent rejection happened. A retry within 24 hours of this timestamp is treated as a deliberate override.
`override_used_at`	When the one-time override was used, or `null` if it hasn't been. Once set, the address is blocked again permanently until the suppression is removed.

Add a suppression

POST /v1/suppressions

Add an email address to the suppression list. A send to a suppressed address is rejected with a clear reason (not silently dropped) -- see Sending to a suppressed recipient for the full behavior, including the one-time retry override for addresses suppressed by mistake.

Request body:

{
  "email_address": "[email protected]",
  "reason": "manual"
}

Field	Type	Required	Description
`email_address`	string	Yes	The email address to suppress.
`reason`	string	No	Reason for suppression. Defaults to `"manual"`.

Valid reasons:

Reason	Description
`bounce`	The address hard-bounced.
`complaint`	The recipient filed a spam complaint.
`manual`	Manually added by an account user or API call.

curl -X POST https://mail.axene.io/v1/suppressions \
  -H "Authorization: Bearer axm_k_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email_address": "[email protected]",
    "reason": "manual"
  }'

Response (201 Created):

{
  "id": "sup_ghi789",
  "email_address": "[email protected]",
  "reason": "manual"
}

Remove a suppression

DELETE /v1/suppressions/{suppression_id}

Remove an email address from the suppression list, allowing future emails to be delivered to it.

cURL:

curl -X DELETE https://mail.axene.io/v1/suppressions/sup_ghi789 \
  -H "Authorization: Bearer axm_k_YOUR_API_KEY"

Python:

import requests
 
response = requests.delete(
    "https://mail.axene.io/v1/suppressions/sup_ghi789",
    headers={"Authorization": "Bearer axm_k_YOUR_API_KEY"},
)
# 204 No Content on success

Node.js:

const response = await fetch(
  "https://mail.axene.io/v1/suppressions/sup_ghi789",
  {
    method: "DELETE",
    headers: { Authorization: "Bearer axm_k_YOUR_API_KEY" },
  }
);
// 204 No Content on success

Response: 204 No Content

No response body is returned.

Bulk suppress from CSV

POST /v1/suppressions/bulk

Upload a CSV file of email addresses to add to the suppression list in bulk. The file is read line by line; each line is treated as one email address (surrounding quotes and commas are stripped). Lines without an @ are ignored.

Bulk suppression requires the Starter plan or above. Free plan users will receive a 403 error.

Request: multipart/form-data with a file field containing the CSV.

cURL:

curl -X POST https://mail.axene.io/v1/suppressions/bulk \
  -H "Authorization: Bearer axm_k_YOUR_API_KEY" \
  -F "[email protected]"

Python:

import requests
 
with open("suppressions.csv", "rb") as f:
    response = requests.post(
        "https://mail.axene.io/v1/suppressions/bulk",
        headers={"Authorization": "Bearer axm_k_YOUR_API_KEY"},
        files={"file": ("suppressions.csv", f, "text/csv")},
    )
print(response.json())

Node.js:

const fs = require("fs");
const FormData = require("form-data");
 
const form = new FormData();
form.append("file", fs.createReadStream("suppressions.csv"));
 
const response = await fetch("https://mail.axene.io/v1/suppressions/bulk", {
  method: "POST",
  headers: {
    Authorization: "Bearer axm_k_YOUR_API_KEY",
    ...form.getHeaders(),
  },
  body: form,
});
const data = await response.json();

Response (201 Created):

{
  "added": 142,
  "skipped": 8,
  "total_processed": 150
}

Field	Type	Description
`added`	integer	Number of new emails added to the suppression list.
`skipped`	integer	Number of emails that were already suppressed or invalid.
`total_processed`	integer	Total rows processed from the CSV.

Errors

Status	Cause
`400 Bad Request`	Invalid email address format or missing required fields.
`401 Unauthorized`	Missing or invalid authentication token.
`403 Forbidden`	Plan does not support this feature (bulk suppress on Free plan).
`404 Not Found`	Suppression ID does not exist.
`409 Conflict`	Email address is already on the suppression list.
`422 Unprocessable Entity`	Request body validation failed.

Suppressions API

List suppressions

Add a suppression

Remove a suppression

Bulk suppress from CSV

Errors

On this page