---
title: "Search and Filter Contacts"
method: POST
path: "/contact/search/v1-hold"
tags: ["contact"]
---

# Search and Filter Contacts

`POST /contact/search/v1-hold`

## Request

- Base URL: `http://localhost:8080/api`
- URL: `http://localhost:8080/api/contact/search/v1-hold`
- Auth: none declared
- TypeScript: <https://skmtc.dev/adapt/apis/saleslift-api/docs/contact/search/v1-hold/post.ts> (a function with typed inputs; its response is checked against the schema)

Search Contacts based on title, department, level , headcount, annual revenue and much more

## Request body

- SearchEndpointRequest
  - `name` string[]: name
  - `firstName` string[]: first name
  - `lastName` string[]: last name
  - `title` string[]: title
  - `dept` string[]: department
  - `level` string[]: level
  - `companyName` string[]: company name
  - `nameDomain` string[]: nameDomain
  - `numberOfEmployees` string[]: number of employees
  - `revenue` string[]: revenue
  - `industryName` string[]: industry name
  - `subIndustry` string[]: subIndustry name
  - `city` string[]: city
  - `country` string[]: country
  - `state` string[]: state
  - `zipCode` string[]: zipcode
  - `technologies` string[]: technologies
  - `dontDisplayOwnedContacts` boolean
  - `limit` integer: number of requests
  - `minimumEmailDeliverabilityScore` integer: Minimum email Deliverability Score
  - `locationPreferences` string: Use contacts or company or both
  - `cursorMark` string: cursorMark is used to paginate, in the first request '*' we to sent for its values and for sub subsequent requests, its value will be obtained from the previous request
  - `titleExactMatch` boolean
  - `excludeTitleKeywords` string[]
  - `dontDisplayDeadContacts` boolean
  - `displayOnlyContactsWithAnyPhoneNumbers` boolean
  - `displayOnlyMobileNumberContacts` boolean
  - `displayOnlyDirectDialContacts` boolean
  - `offset` integer: number of contact skip

## Response `200`

OK

## Other responses

- `204`: Resource not found
- `400`: Bad Request
- `401`: Authentication Failed
- `402`: Insufficient API credits
- `403`: API Access Denied

---

[API](https://skmtc.dev/adapt/apis/saleslift-api.md) - [All operations](https://skmtc.dev/adapt/apis/saleslift-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adapt/apis/saleslift-api/revisions/87f442a3336e?raw)