Skip to Content
CallMitraDocs
API referenceDo not call

List do-not-call numbers

The 500 most recently changed leads marked do-not-call, newest first. The list stops at 500 entries; `hasMore` is true when older entries were left out. The dialer never calls these numbers.

GET
/api/v1/leads/dnc

The 500 most recently changed leads marked do-not-call, newest first. The list stops at 500 entries; hasMore is true when older entries were left out. The dialer never calls these numbers.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Response Body

OK

application/json
  1. response

The workspace's do-not-call list: the 500 most recently changed entries.

entries*array<>

Leads marked do-not-call, newest change first.

hasMore?Hasmore

True when more than 500 leads are marked do-not-call and older entries were left out.

Defaultfalse
success?Success

Always true on a 2xx response.

Defaulttrue
total?|

Number of entries in this response (at most 500).

[key: string]?any
Example Request
curl -X GET 'https://api.callmitra.ai/api/v1/leads/dnc'
Example Response
{  "entries": [    {      "createdAt": "2026-11-01T09:30:00Z",      "dncOptOut": true,      "dncReason": "Asked not to be called",      "dncUpdatedAt": "2026-11-15T10:00:00Z",      "id": "5d2f8a1e-3b4c-4d6e-9f0a-1b2c3d4e5f60",      "name": "Asha Rao",      "phone": "+919876543210",      "status": "new"    }  ],  "hasMore": false,  "success": true,  "total": 1}