> ## 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.

# Check a Number

> Which suppression lists block a number for an organization's calls

Returns every list that holds the number for calls placed by an organization: its own list, its reseller's and its partner's. This is the same check an outbound call runs before it is placed. Use it to find out why a call was refused with `409 suppressed`.

An account key can check any organization in the account. A reseller key can check organizations under its reseller. An organization key can check only its own organization.

## Query Parameters

**to\_number** `string` *required*

The E.164 number, e.g. `+15105550123`. Percent-encode the `+` (`%2B15105550123`); an unencoded `+` is recovered too.

**organization\_id** `string` *required*

The UUID of the organization placing the calls

## Response

**to\_number** `string`

The number checked, in E.164

**organization\_id** `string`

The organization checked

**suppressed** `boolean`

`true` when any list holds the number

**scopes** `string[]`

Every list holding the number, most specific first: `organization`, `reseller`, `partner`. Empty when the number is not suppressed. The first entry is the `suppression_scope` a refused trigger reports.

```bash cURL theme={null}
curl "https://api.telzino.com/v1/suppression-check?to_number=%2B15105550123&organization_id=234cd323-…" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

```json 200 theme={null}
{
  "data": {
    "to_number": "+15105550123",
    "organization_id": "234cd323-…",
    "suppressed": true,
    "scopes": ["reseller", "partner"]
  }
}
```

| Code | Meaning |
| - | - |
| `200` | Checked |
| `400` | `organization_id` is missing, or `to_number` is not E.164 |
| `404` | Organization not found or access denied |
| `500` | The lists could not be read |


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