---
title: "Search leads"
method: POST
path: "/public/v1/insights/contacts"
tags: ["Search"]
---

# Search leads

`POST /public/v1/insights/contacts`

This API endpoint finds contacts with emails in GetProspect B2B leads’ database by different search criteria.

## Query parameters

- `pageSize` number
- `pageNumber` number
- `sort` 'id' | 'firstName' | 'lastName' | 'contactInfo' | 'summary' | 'geolocation.region' | 'geolocation.timezone' | 'geolocation.location' | 'geolocation.countryCode'
- `order` 'ASC' | 'DESC'

## Request body

- InsightSearchContactsDto
  - `contactName` SearchTextContactFilter
    - `included` string[]
    - `excluded` string[]
  - `companyName` SearchTextContactFilter
    - `included` string[]
    - `excluded` string[]
  - `jobTitle` SearchTextContactFilter
    - `included` string[]
    - `excluded` string[]
  - `seniority` SearchSeniorityContactFilter
    - `included` 'Owner' | 'Partner' | 'Chief Officer' | 'VP' | 'Director' | 'Senior' | 'Manager' | 'Intern' | 'Unpaid'
    - `excluded` 'Owner' | 'Partner' | 'Chief Officer' | 'VP' | 'Director' | 'Senior' | 'Manager' | 'Intern' | 'Unpaid'
  - `domain` SearchTextContactFilter
    - `included` string[]
    - `excluded` string[]
  - `industry` SearchIndustryContactFilter
    - `included` string[]
    - `excluded` string[]
  - `location` SearchTextContactFilter
    - `included` string[]
    - `excluded` string[]
  - `keywords` SearchTextContactFilter
    - `included` string[]
    - `excluded` string[]
  - `headquarters` SearchTextContactFilter
    - `included` string[]
    - `excluded` string[]
  - `employees` SearchCountContactFilter
    - `included` '1 - 10' | '11 - 20' | '21 - 50' | '51 - 100' | '101 - 200' | '201 - 500' | '501 - 1000' | '1001 - 2000' | '2001 - 5000' | '5001 - 10000' | '10000'
  - `lastUpdated` string, full-date
  - `email` 'all' | 'all_contacts'

## Response `200`

Entity given

- PaginatedContactsData
  - `data` ContactResponseDto[], required
    - `getProspectId` string, required
    - `firstName` string
    - `lastName` string
    - `contactInfo` string
    - `summary` string
    - `companies` 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
    - `lastUpdatedAt` string, required
    - `linkedin` LinkedinResponseDto[], required
      - `id` string, required
      - `type` string, required
    - `geolocation` Geolocation, required
      - `location` string, required
      - `countryCode` string, required
      - `region` string, required
      - `timezone` string, required
  - `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)