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

# Prospect Companies

`POST /v2/prospect/companies`

## Request

- Base URL: `https://api.sanka.com`
- URL: `https://api.sanka.com/v2/prospect/companies`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sankahq/apis/sanka-public-api/docs/v2/prospect/companies/post.ts> (a function with typed inputs; its response is checked against the schema)

## 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

## Changes

- **2026-07-06** `6ce94a6be72c`: 6 info
  - added the optional property `meta/pagination/next_cursor` to the response with the `200` status
  - added the optional property `meta/pagination/next_cursor` to the response with the `401` status
  - added the optional property `meta/pagination/next_cursor` to the response with the `422` status
  - added the optional property `meta/toast` to the response with the `200` status
  - …2 more
- **2026-06-10** `9099b22c3aae`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sankahq/apis/sanka-public-api/changes/v2/prospect/companies/post.md)

---

[API](https://skmtc.dev/sankahq/apis/sanka-public-api.md) - [All operations](https://skmtc.dev/sankahq/apis/sanka-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sankahq/apis/sanka-public-api/revisions/16f03a9e3ab9?raw)