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

# List Do-Not-Call Numbers

> The numbers your workspace must not call. Campaigns skip them

List the do-not-call numbers of your workspace, newest first. Campaigns skip these numbers when a file is uploaded and again when a call is due.

## Request

### Headers

**Authorization** `string` *required*

Bearer token with your API key (scope `agents`)

### Query

**q** `string`

Part of the phone number. Up to 100 characters

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

1 to 100. Values outside the range are clamped

**offset** `integer` (default: 0)

Number of entries to skip

## Response

**200 OK**. `data` is the array. `pagination` holds `total`, `limit` and `offset`.

```json theme={null}
{
  "success": true,
  "data": [
    {
      "id": "5a0e7c31-9d2b-4e6f-8a1c-3b4d5e6f7a8b",
      "phone": "+919876543210",
      "reason": "Asked not to be called",
      "created_at": "2026-11-10T08:12:00.000Z"
    }
  ],
  "pagination": { "total": 1, "limit": 50, "offset": 0 }
}
```

## Errors

| Status | Code | Meaning |
| - | - | - |
| 403 | `POLICY_DENY` | Your role cannot read campaigns, or the API key lacks the `agents` scope |

## Example

```bash cURL theme={null}
curl "https://api.60db.ai/agents/do-not-call?q=9876" \
  -H "Authorization: Bearer your-api-key"
```


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