---
title: "Find companies by identity"
method: POST
path: "/api/v1/companies/search"
tags: ["Companies"]
---

# Find companies by identity

`POST /api/v1/companies/search`

## Request

- Base URL: `https://targetwise.ai`
- URL: `https://targetwise.ai/api/v1/companies/search`
- Auth: HTTP bearer

Searches company names, websites or registration numbers. Returns at most five company candidates per page. Calls are metered.

## Request body

- union
  - object
    - `name` string, required
    - `website_url` string, uri
    - `registration_number` string
    - `country_code` string
    - `page` integer
    - `limit` integer
  - object
    - `name` string
    - `website_url` string, uri, required
    - `registration_number` string
    - `country_code` string
    - `page` integer
    - `limit` integer
  - object
    - `name` string
    - `website_url` string, uri
    - `registration_number` string, required
    - `country_code` string
    - `page` integer
    - `limit` integer

## Response `200`

A normalized match, partial match or no-match result.

- object
  - `object` 'prospecting_result', required
  - `operation` 'company_search', required
  - `request_id` string, required
  - `status` 'matched' | 'not_found', required
  - `data` object[], required
    - `company_id` string
    - `company_name` string
  - `pagination` object, required
    - `page` integer, required
    - `per_page` integer, required
    - `total_results` integer, required
    - `total_pages` integer, required
    - `has_more` boolean, required
  - `grounding` object, required
    - `retrieved_at` string, date-time, required
    - `source_provenance` 'not_available', required

## Other responses

- `400`: Invalid request or operation_pricing_unavailable. Adding credit does not enable an unpriced operation.
- `401`: A valid TargetWise bearer key is required.
- `402`: Free allowance or paid balance exhausted, or usage_budget_reached. A top-up does not increase the monthly usage budget.
- `403`: The workspace is inactive or access is restricted.
- `409`: Workspace usage could not be reserved. Inspect retryable before a bounded retry.
- `413`: The request body exceeds 64 KB.
- `415`: Use Content-Type: application/json.
- `429`: The workspace attempt/rate limit or provider limit has been reached.
- `500`: Unexpected internal error.
- `502`: The data connection returned an unusable response.
- `503`: The service or data connection is unavailable or unconfigured.
- `504`: The data connection timed out.

---

[API](https://skmtc.dev/targetwise/apis/targetwise-prospecting-enrichment-api.md) · [All operations](https://skmtc.dev/targetwise/apis/targetwise-prospecting-enrichment-api/llms.txt) · [OpenAPI document](https://skmtc.dev/targetwise/apis/targetwise-prospecting-enrichment-api/revisions/bd436a05769d?raw)