---
title: "Search contacts"
method: POST
path: "/api/v1/contacts/contact/search"
tags: ["Contacts"]
---

# Search contacts

`POST /api/v1/contacts/contact/search`

This API endpoint retrieves all the saved contacts by particular filter(s)

## Query parameters

- `includeCount` boolean
- `pageSize` number
- `pageNumber` number
- `sort` string
- `order` 'ASC' | 'DESC'

## Request body

- SearchContactsDto
  - `filters` FilterItem[]
    - `operator` 'EQ' | 'NEQ' | 'IS_NOT_EMPTY' | 'IS_EMPTY' | 'CONTAINS' | 'LT' | 'LTE' | 'GT' | 'GTE' | 'LIKE' | 'NOT_LIKE' | 'CONTAINS_ANY' | 'NOT_CONTAINS_ANY' | 'NOT_EXISTS' — * EQ - equal to * NEQ - not equal to * LT - larger than * LTE - larger than or equal to * GT - greater than * GTE - greater than or equal to
    - `property` string, required
    - `value` string
  - `includeRelations` boolean — Includes companies, owner and lists in each of contacts. The value “true” can slow down the performance of the request. Default - false
  - `includes` string[] — Company fields(domain, name and etc.)
  - `deleted` boolean — Returns only deleted contacts if true. Default - false.
  - `searchId` string

## Response `200`

Entity given

- PaginatedContactData
  - `data` ContactModel[], required
    - `_id` ObjectId, required
    - `owner` ObjectId, required
    - `source` string, required
    - `properties` object, required
    - `deleted` boolean, required
    - `workspaceId` number, required
    - `search` ObjectId, required
    - `listRelations` string[], required
    - `companyRelations` CompanyRelation[], required
      - `email` Email
        - `status` 'valid' | 'not found' | 'not checked', required
        - `value` string
        - `lastCheckedAt` string
      - `position` string, required
      - `company` Company, required
        - `getProspectId` string, required
        - `domain` string
        - `name` string
    - `insightId` ObjectId, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `linkedin` ContactLinkedin[], required
      - `id` string, required
      - `type` 'common' | 'sales', required
    - `linkedinId` string
  - `meta` Meta, required
    - `totalPages` number, required
    - `totalItems` number, required
    - `savedItems` number, required
    - `pageSize` number, required
    - `page` number, required
    - `sort` Sort, required
      - `column` string, required
      - `order` 'ASC' | 'DESC', required
    - `additionalInfo` object, required

## Other responses

- `400` — Bad model
- `401` — Unauthorized user

---

[API](https://skmtc.net/getprospect/apis/calls.md) · [All operations](https://skmtc.net/getprospect/apis/calls/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getprospect/calls/revisions/5211a12644da/schema)