---
title: "Prospect Companies"
method: POST
path: "/v2/prospect/companies"
tags: ["ai"]
---

# Prospect Companies

`POST /v2/prospect/companies`

## Query parameters

- `workspace_id` string, nullable

## Headers

- `X-Workspace-Code` string

## Request body

- ProspectCompaniesRequest
  - `query` string, nullable
  - `location` string, nullable
  - `industry` string, nullable
  - `min_employee_count` integer, nullable
  - `max_employee_count` integer, nullable
  - `limit` integer
  - `sources` string[]

## Response `200`

Successful Response

- ProspectCompaniesApiV2ProspectCompaniesPost200Envelope
  - `success` true, required
  - `data` ProspectCompaniesData, required
    - `query` string, nullable
    - `parsed_filters` ProspectCompaniesFilters, required
      - `query` string, nullable
      - `location` string, nullable
      - `industry` string, nullable
      - `min_employee_count` integer, nullable
      - `max_employee_count` integer, nullable
    - `results` ProspectCompanyData[]
      - `name` string, nullable
      - `url` string, nullable
      - `domain` string, nullable
      - `industry` string, nullable
      - `employee_count` integer, nullable
      - `employee_count_display` string, nullable
      - `address` string, nullable
      - `email` string, nullable
      - `phone_number` string, nullable
      - `linkedin_url` string, nullable
      - `description` string, nullable
      - `source_urls` string[]
      - `sources` string[]
      - `relevance_score` number
      - `match_reasons` string[]
      - `provider_meta` object
    - `count` integer, required
    - `provider_meta` object
  - `meta` EnvelopeMeta, required
    - `ctx_id` string, required
    - `pagination` PaginationMeta
      - `page` integer, required
      - `page_size` integer, required
      - `total` integer, required
      - `next_cursor` string, nullable
    - `toast` ToastMessage
      - `variant` 'success' | 'error' | 'info' | 'warning', required
      - `code` string, required
      - `message` string, required
      - `i18n` ToastMessageI18n, required
        - `en` string, required
        - `ja` string, required

## Other responses

- `401` — Error response
- `422` — Error response

---

[API](https://skmtc.net/sankahq/apis/sanka-public-api.md) · [All operations](https://skmtc.net/sankahq/apis/sanka-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sankahq/sanka-public-api/revisions/dbb716222666/schema)