Get data-removal status
Poll an erasure request for completion and per-table counts.
Erasures usually finish within seconds; large accounts with millions of rows can take longer. Once done, counts reports exactly how many rows were touched per table — useful for the record you keep of the data-subject request.
GET /v3/data-removals/{id}
Response fields
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | Optional | pending → processing → done (or failed with the error). |
counts | object | Optional | { messages, events, verifications, upload_downloads } — rows redacted/deleted per table. Null until done. |
created_at / completed_at | ISO-8601 | Optional | When the request was made and when the erasure finished. |
Responses
| Status | Description |
|---|---|
200 | The removal request. |
404 | No such removal on your account. |
Code examples
cURL
curl https://api.wemail.io/v3/data-removals/{id} \
-H "Authorization: Bearer afn_live_…"Node.js
const res = await fetch("https://api.wemail.io/v3/data-removals/{id}", {
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/data-removals/{id}",
headers={"Authorization": f"Bearer {os.environ['WEMAIL_API_KEY']}"},
)
data = r.json()