Audit log
Every key creation, domain change, suppression edit and configuration change is logged.
Every key creation, domain change, suppression edit and configuration change is logged with the actor, source IP and details. Entries are returned newest-first.
GET /v3/audit
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page | integer | Optional | Page number, starting at 1. Default 1. |
per_page | integer | Optional | Entries per page, 1–100. Default 25. |
action | string | Optional | Exact action filter, e.g. key.created. |
actor_type | string | Optional | Who performed the action: user, staff or system. |
since | ISO-8601 | Optional | Only entries at or after this time. |
until | ISO-8601 | Optional | Only entries at or before this time. |
Responses
| Status | Description |
|---|---|
200 | OK. A page of audit-log entries (action, target, actor, ip_address, details, created_at). |
400 | Invalid query parameters. |
401 | Missing or invalid API key. |
Code examples
cURL
curl https://api.wemail.io/v3/audit \
-H "Authorization: Bearer afn_live_…"Node.js
const res = await fetch("https://api.wemail.io/v3/audit", {
headers: {
Authorization: `Bearer ${process.env.WEMAIL_API_KEY}`,
},
});
const data = await res.json();Python
import os, requests
r = requests.get(
"https://api.wemail.io/v3/audit",
headers={"Authorization": f"Bearer {os.environ['WEMAIL_API_KEY']}"},
)
data = r.json()