List the do-not-email list
Who unsubscribed or was blocked, newest first.
GET
/api/v1/do-not-emailScope
contacts:readReturns a page of entries, newest first.
Query parameters
Prop
Type
Example request
curl "https://api.pedibee.com/api/v1/do-not-email?since=2026-10-01T00:00:00Z&limit=200" \
-H "Authorization: Bearer $PEDIBEE_API_KEY"Response
{
"data": [
{
"id": "66f1c2a9e4b0a1b2c3d4e777",
"email": "jane@northwind.io",
"reason": "UNSUBSCRIBED",
"via": "LINK",
"feedback": "TOO_MANY",
"contactId": "66f1c2a9e4b0a1b2c3d4e5f6",
"outreachNumber": 3,
"source": { "kind": "CAMPAIGN", "id": "66f1c2a9e4b0a1b2c3d4e200", "name": "Spring launch" },
"createdAt": "2026-10-05T09:30:00.000Z"
}
],
"total": 1,
"skip": 0,
"limit": 200
}Errors
Every error is { "error": "…" } with a message you can show. See Errors and limits.
| Status | When |
|---|---|
400 | since isn't a date. |
403 | The key doesn't have contacts:read, or its creator's role no longer allows it. |
401 | The API key is missing, invalid, revoked or expired. |
429 | Too many requests. Wait for the seconds in Retry-After. |