curl -X POST "https://api.telzino.com/v1/resellers/5c4b3a29-…/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/resellers/5c4b3a29-…/suppression-list?page=1&limit=50" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
curl -X DELETE "https://api.telzino.com/v1/resellers/5c4b3a29-…/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": 1
}
}
{
"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" } }
Suppression List
Reseller Suppression List
The reseller’s outbound do-not-call list, which blocks calls from every organization under the reseller
POST
/
v1
/
resellers
/
{reseller_id}
/
suppression-list
curl -X POST "https://api.telzino.com/v1/resellers/5c4b3a29-…/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/resellers/5c4b3a29-…/suppression-list?page=1&limit=50" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
curl -X DELETE "https://api.telzino.com/v1/resellers/5c4b3a29-…/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": 1
}
}
{
"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" } }
A number on a reseller’s list is never dialled by any organization under that reseller. A trigger for it is refused with
A reseller key sent to another reseller’s list gets
Removals are audited: who removed the number, when, and the entry it replaced are kept.
409 suppressed and suppression_scope: "reseller". 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 reseller-wide suppression is on and partner-wide suppression is off. Numbers added by hand block calls whatever the setting.
Who can use it
| API key | Read | Add / remove |
|---|---|---|
| Account | Any reseller in the account | Any reseller in the account |
| Reseller | Its own reseller only | Its own reseller only |
| Organization | No (403 forbidden) | No (403 forbidden) |
403 forbidden.
Path Parameters
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 reseller.
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/resellers/5c4b3a29-…/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/resellers/5c4b3a29-…/suppression-list?page=1&limit=50" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
curl -X DELETE "https://api.telzino.com/v1/resellers/5c4b3a29-…/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": 1
}
}
{
"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" } }
| 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 reach this reseller’s list |
404 | Reseller not found or access denied, or the number is not on the list |