---
title: "Search People"
method: POST
path: "/api/v2/prime-db/leads/search"
---

# Search People

`POST /api/v2/prime-db/leads/search`

## Request

- Base URL: `https://api.dropleads.io`
- URL: `https://api.dropleads.io/api/v2/prime-db/leads/search`
- Auth: API key in header `X-API-Key`

Search for contacts using filters. Returns masked data (no email/phone revealed).
**Does not consume credits**.

## Headers

- `Content-Type` string, required

## Request body

- object
  - `filters` object: All fields optional. Combined with AND. Most array filters support a parallel `*Exclude` key.
    - `jobTitles` string[]: Partial match with synonym/abbreviation expansion.
    - `jobTitlesExclude` string[]
    - `jobTitlesSimilar` string[]: Flexible word-order matching.
    - `industries` string[]
    - `industriesExclude` string[]
    - `keywords` string[]
    - `keywordsExclude` string[]
    - `technologies` string[]
    - `technologiesExclude` string[]
    - `departments` string[]
    - `departmentsExclude` string[]
    - `seniority` string[]
    - `seniorityExclude` string[]
    - `companyNames` string[]
    - `companyDomains` string[]
    - `linkedinUrls` string[]
    - `employeeRanges` string[]
    - `customEmployeeRange` object: Overrides employeeRanges.
      - `min` integer
      - `max` integer
    - `revenueRange` object
      - `min` number, nullable
      - `max` number, nullable
    - `fundingRange` object
      - `min` number, nullable
      - `max` number, nullable
    - `foundedYear` object
      - `min` integer, nullable
      - `max` integer, nullable
    - `countries` string[]: Shorthand location filter (personal+organization combined).
    - `states` string[]
    - `cities` string[]
    - `locationScope` 'personal' | 'company' | 'both'
    - `personalCountries` object
      - `include` string[]
      - `exclude` string[]
    - `personalStates` object
      - `include` string[]
      - `exclude` string[]
    - `personalCities` object
      - `include` string[]
      - `exclude` string[]
    - `personalRegions` object: Expands to countries (North America, EMEA, APAC, LATAM).
      - `include` string[]
      - `exclude` string[]
    - `organizationCountries` object
      - `include` string[]
      - `exclude` string[]
    - `organizationStates` object
      - `include` string[]
      - `exclude` string[]
    - `organizationCities` object
      - `include` string[]
      - `exclude` string[]
    - `organizationRegions` object: Expands to company HQ countries.
      - `include` string[]
      - `exclude` string[]
    - `lists` object
      - `type` 'include' | 'exclude'
      - `listIds` string[]
    - `companyLists` object: Include leads whose company domain belongs to these saved company lists.
      - `listIds` string[]
    - `segments` string[]
    - `segmentsExclude` string[]
    - `buyingIntent` string: Buying intent keyword filter.
    - `requireEmail` boolean: Only return leads with a non-empty email.
  - `pagination` object
    - `page` integer
    - `limit` integer

## Response `200`

Successful response

- object
  - `success` boolean
  - `data` object
    - `leads` object[]
      - `id` string
      - `first_name` string
      - `last_name` string
      - `title` string
      - `email` string: Masked email
      - `linkedin_url` string
      - `organization_name` string
      - `organization_industry` string
      - `city` string
      - `state` string
      - `country` string
      - `is_enriched` boolean
    - `total` integer
  - `pagination` object
    - `page` integer
    - `limit` integer
    - `total` integer
    - `totalPages` integer

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `402`: Insufficient credits
- `404`: Not found

---

[API](https://skmtc.dev/dropleads/apis/data-enrichment.md) - [All operations](https://skmtc.dev/dropleads/apis/data-enrichment/llms.txt) - [OpenAPI document](https://skmtc.dev/dropleads/apis/data-enrichment/revisions/293a8d3add39?raw)