---
title: "Search DNC item across all lists"
method: GET
path: "/v1/dnc/item/search"
tags: ["do-not-contact"]
---

# Search DNC item across all lists

`GET /v1/dnc/item/search`

## Request

- Base URL: `https://developer.saleshandy.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.saleshandy.com/v1/dnc/item/search`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/docs/v1/dnc/item/search/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `search` string
- `pageSize` number
- `page` number
- `type` 'all' | 'email' | 'domain', required

## Response `200`

Successfully fetched dnc list with items<br><br>

- FetchDncListResponseDto
  - `message` string: Response message indicating the status of the request.
  - `payload` FetchDncListResponse
    - `dncList` DncList[]: Array of DNC lists with their details.
      - `id` string: Unique identifier for the DNC list.
      - `name` string: Name of the DNC list.
      - `numberOfItems` number: Total number of items in the DNC list.
      - `createdAt` string: Timestamp when this DNC list was created.
      - `updatedAt` string: Timestamp when this DNC list was last updated.
      - `addedBy` string: Name of the person who added this DNC list.
      - `ownerId` string: Unique identifier for the owner of the DNC list.
      - `dncItems` DncItems[]: Details of the items within the DNC list.
        - `id` string: Unique identifier for the DNC list detail.
        - `value` string: The value of the DNC item, such as an email address or domain.
        - `type` string: The type of DNC item ("email" and "domain").
        - `createdAt` string: Timestamp when this DNC list detail was created.
    - `meta` Meta
      - `totalItems` number: Total number of items available.
      - `currentPage` number: Current page number.
      - `itemsPerPage` number: Number of items displayed per page.
      - `totalPages` number: Total number of pages available.
      - `itemCount` number: Number of items on the current page.

## Other responses

- `400`: 40004: Failed to fetch dnc item<br><br>
- `500`: 5001: Internal server error, please try again later<br><br>

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) - [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) - [OpenAPI document](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/revisions/e7a29c931aa7?raw)