---
title: "Search people"
method: POST
path: "/api/v1/people/search"
tags: ["People Search"]
---

# Search people

`POST /api/v1/people/search`

Async people discovery. Returns operationId; poll GET /api/operations/:id.

## Headers

- `Idempotency-Key` string

## Request body

- PostPeopleSearchDto
  - `query` string, required
  - `limit` number
  - `includeSignals` boolean
  - `includeContacts` boolean
  - `contactFields` string[] — Contact fields to enrich when includeContacts is true. Omit to preserve legacy includeContacts=true behavior, which requests both email and phone.
  - `maxCredits` number — Maximum credits the people search operation may charge. When omitted, normal account limits apply.
  - `filters` EntitySearchFiltersDto
    - `titles` string[]
    - `titleMatch` 'exact' | 'similar'
    - `locations` string[]
    - `industries` string[]
    - `employeeCount` EntityEmployeeCountFilterDto
      - `min` number
      - `max` number
    - `signals` string[]
    - `company` EntityCompanyNestedFilterDto
      - `names` string[]
      - `domains` string[]
      - `linkedinUrls` string[]
      - `industries` string[]
      - `employeeCount` EntityEmployeeCountFilterDto
        - `min` number
        - `max` number
      - `signals` string[]
  - `confirm` boolean

## Response `202`

People search accepted. Poll the returned URL for results.

- EntitySearchAcceptedDto
  - `id` string, required
  - `operationId` string, required
  - `status` 'queued', required
  - `pollUrl` string, required
  - `meta` object, required

## Other responses

- `400` — The request body or parameters are invalid.
- `401` — Authentication is required.
- `402` — The organization does not have enough credits for this request.
- `500` — An unexpected error occurred.

---

[API](https://skmtc.net/thehog/apis/the-hog-api.md) · [All operations](https://skmtc.net/thehog/apis/the-hog-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thehog/the-hog-api/revisions/f5056017668a/schema)