> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telzino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Partner Suppression List

> The partner's outbound do-not-call list, which blocks calls from every reseller and organization under the partner

A number on the partner list is never dialled by any organization under the partner (the account). A [trigger](https://docs.telzino.com/api-reference/outbound-calls/create.md) for it is refused with `409 suppressed` and `suppression_scope: "partner"`. See [Outbound Compliance](https://docs.telzino.com/functions/outbound-compliance.md#suppression-list).

`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](https://docs.telzino.com/api-reference/suppression-list/list-add.md).

Mid-call opt-outs are written here only while [partner-wide suppression](https://docs.telzino.com/api-reference/suppression-list/settings.md) 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

**account\_id** `string` *required*

The partner's account UUID. It must be the account of your API key; any other id returns `404`.

**number** `string`

`DELETE` only. The E.164 number, percent-encoded (`%2B15105550123`); the raw form is accepted too.

## Query Parameters (GET)

**page** `integer` (default: 1)

Page number

**limit** `integer` (default: 50)

Entries per page (max 100)

## Request Body (POST)

**phone\_number** `string` *required*

E.164, e.g. `+15105550123`. Matched **exactly** against the dialled number.

**reason** `string` (default: manual)

One of `opt_out`, `manual`, `complaint`, `litigation`, `other`.

**notes** `string`

Up to 1000 characters.

> [!NOTE]
>
> 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.

Removals are audited: who removed the number, when, and the entry it replaced are kept.

```bash cURL (add) theme={null}
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" }'
```

```bash cURL (list) theme={null}
curl "https://api.telzino.com/v1/accounts/7f1e2d3c-…/suppression-list?page=1&limit=50" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

```bash cURL (remove) theme={null}
curl -X DELETE "https://api.telzino.com/v1/accounts/7f1e2d3c-…/suppression-list/%2B15105550123" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

```json 201 theme={null}
{
  "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
  }
}
```

```json 200 (list) theme={null}
{
  "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 }
}
```

```json 200 (remove) theme={null}
{ "data": { "phone_number": "+15105550123" } }
```

```json 403 theme={null}
{
  "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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.