---
title: "Search companies"
method: POST
path: "/api/v1/companies/search"
tags: ["Company Search"]
---

# Search companies

`POST /api/v1/companies/search`

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

## Headers

- `Idempotency-Key` string

## Request body

- PostCompanySearchDto
  - `query` string, required
  - `limit` number
  - `includeSignals` boolean
  - `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`

Company search accepted. Poll the returned URL for results.

- EntitySearchAcceptedPublicDto
  - `id` string, required
  - `operationId` string, required
  - `status` 'queued', required
  - `pollUrl` string, 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)