---
title: "Find do not contact (dnc) items"
method: GET
path: "/contacts/dncs"
tags: ["contacts"]
---

# Find do not contact (dnc) items

`GET /contacts/dncs`

Searches for all Do Not Contact (DNC) objects created by user. These DoNotContact entries only affect calls/texts/campaigns on this account. Returns a paged list of DoNotContact objects

## Query parameters

- `fields` string
- `limit` integer
- `offset` integer
- `prefix` string
- `campaignId` integer
- `source` string
- `call` boolean
- `text` boolean
- `inboundCall` boolean
- `inboundText` boolean
- `number` string[]

## Response `200`

successful operation

- DoNotContactPage — ~
  - `items` object[] — A list of returned items
    - `number` string — A single DNC number in E.164 format (11-digit). Example: 12132000384
    - `call` boolean — A number on Do-Not-Call list
    - `text` boolean — A number on Do-Not-Text list
    - `inboundCall` boolean — ~
    - `inboundText` boolean — ~
    - `source` string — The name of DNC source (can be the name of DNC list that user uploads to CallFire)
    - `campaignId` integer — An Id of a campaign which was used to send a message to DNC number
    - `created` integer — A time when a given resource was created, formatted in unix time milliseconds (read only). Example: 1473781817000 for Sat, 05 Jan 1985 14:03:37 GMT
  - `limit` integer — A maximum number of returned items. If items.size() < limit assume no more items
  - `offset` integer — An offset from a start of paging source
  - `totalCount` integer — Total count of available results. -1 if unknown

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/callfire/apis/callfire-api-documentation.md) · [All operations](https://skmtc.dev/callfire/apis/callfire-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/callfire/callfire-api-documentation/revisions/9f6fb501bc03/schema)