curl -X POST "https://api.telzino.com/v1/accounts/7f1e2d3c-…/suppression-list" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "phone_number": "+15105550123", "reason": "opt_out" }'
curl "https://api.telzino.com/v1/accounts/7f1e2d3c-…/suppression-list?page=1&limit=50" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
curl -X DELETE "https://api.telzino.com/v1/accounts/7f1e2d3c-…/suppression-list/%2B15105550123" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
"data": {
"id": "9b8a7c6d-…",
"phone_number": "+15105550123",
"reason": "opt_out",
"notes": null,
"created_by": "api:7f1e2d3c-…",
"created_at": "2026-10-22T18:04:11.000Z",
"cancelled_calls": 2
}
}
{
"data": [
{
"id": "9b8a7c6d-…",
"phone_number": "+15105550123",
"reason": "opt_out",
"notes": null,
"created_by": "api:7f1e2d3c-…",
"created_at": "2026-10-22T18:04:11.000Z"
}
],
"pagination": { "page": 1, "limit": 50, "total": 1, "totalPages": 1, "hasNext": false, "hasPrev": false }
}
{ "data": { "phone_number": "+15105550123" } }
{
"error": "forbidden",
"error_description": "Only the partner can change the partner suppression list"
}
Suppression List
Partner Suppression List
The partner’s outbound do-not-call list, which blocks calls from every reseller and organization under the partner
POST
/
v1
/
accounts
/
{account_id}
/
suppression-list
curl -X POST "https://api.telzino.com/v1/accounts/7f1e2d3c-…/suppression-list" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "phone_number": "+15105550123", "reason": "opt_out" }'
curl "https://api.telzino.com/v1/accounts/7f1e2d3c-…/suppression-list?page=1&limit=50" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
curl -X DELETE "https://api.telzino.com/v1/accounts/7f1e2d3c-…/suppression-list/%2B15105550123" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
"data": {
"id": "9b8a7c6d-…",
"phone_number": "+15105550123",
"reason": "opt_out",
"notes": null,
"created_by": "api:7f1e2d3c-…",
"created_at": "2026-10-22T18:04:11.000Z",
"cancelled_calls": 2
}
}
{
"data": [
{
"id": "9b8a7c6d-…",
"phone_number": "+15105550123",
"reason": "opt_out",
"notes": null,
"created_by": "api:7f1e2d3c-…",
"created_at": "2026-10-22T18:04:11.000Z"
}
],
"pagination": { "page": 1, "limit": 50, "total": 1, "totalPages": 1, "hasNext": false, "hasPrev": false }
}
{ "data": { "phone_number": "+15105550123" } }
{
"error": "forbidden",
"error_description": "Only the partner can change the partner suppression list"
}
A number on the partner list is never dialled by any organization under the partner (the account). A trigger for it is refused with
Removals are audited: who removed the number, when, and the entry it replaced are kept.
409 suppressed and suppression_scope: "partner". See Outbound Compliance.
GET returns one page of entries. POST adds a number. DELETE …/suppression-list/{number} removes one. The request and entry fields are the same as the organization list.
Mid-call opt-outs are written here only while partner-wide suppression is on. Numbers added by hand block calls whatever the setting.
Who can use it
| API key | Read | Add / remove |
|---|---|---|
| Account | Yes | Yes |
| Reseller | Yes | No (403 forbidden) |
| Organization | No (403 forbidden) | No (403 forbidden) |
Path Parameters
The partner’s account UUID. It must be the account of your API key; any other id returns
404.DELETE only. The E.164 number, percent-encoded (%2B15105550123); the raw form is accepted too.Query Parameters (GET)
Request Body (POST)
Adding a number cancels calls already queued or scheduled to it under every organization of the partner.
cancelled_calls in the response says how many. A call already dialling is not stopped. Adding a number that is already listed succeeds, returns existing: true, and still cancels pending calls.curl -X POST "https://api.telzino.com/v1/accounts/7f1e2d3c-…/suppression-list" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "phone_number": "+15105550123", "reason": "opt_out" }'
curl "https://api.telzino.com/v1/accounts/7f1e2d3c-…/suppression-list?page=1&limit=50" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
curl -X DELETE "https://api.telzino.com/v1/accounts/7f1e2d3c-…/suppression-list/%2B15105550123" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
"data": {
"id": "9b8a7c6d-…",
"phone_number": "+15105550123",
"reason": "opt_out",
"notes": null,
"created_by": "api:7f1e2d3c-…",
"created_at": "2026-10-22T18:04:11.000Z",
"cancelled_calls": 2
}
}
{
"data": [
{
"id": "9b8a7c6d-…",
"phone_number": "+15105550123",
"reason": "opt_out",
"notes": null,
"created_by": "api:7f1e2d3c-…",
"created_at": "2026-10-22T18:04:11.000Z"
}
],
"pagination": { "page": 1, "limit": 50, "total": 1, "totalPages": 1, "hasNext": false, "hasPrev": false }
}
{ "data": { "phone_number": "+15105550123" } }
{
"error": "forbidden",
"error_description": "Only the partner can change the partner suppression list"
}
| Code | Meaning |
|---|---|
200 | List returned, or number removed |
201 | Number suppressed (or already was) |
400 | Invalid body or phone number |
403 | The API key cannot read or change this list |
404 | Account not found or access denied, or the number is not on the list |