---
title: "Search contacts at known domains"
method: POST
path: "/api/v1/prospecting/contacts/search"
tags: ["Prospecting"]
---

# Search contacts at known domains

`POST /api/v1/prospecting/contacts/search`

## Request

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

Returns a bounded page of contact candidates for known company domains, optionally narrowed by company location, contact location and seniority. Candidate results exclude email and phone. Calls are metered.

## Request body

- object
  - `domains` string[], required
  - `company_locations` string[]
  - `contact_locations` string[]
  - `seniorities` string[]
  - `page` integer
  - `limit` integer

## Response `200`

A bounded candidate page. An empty result is a normal business outcome.

- object
  - `object` 'prospecting_result', required
  - `operation` 'contact_prospecting', required
  - `request_id` string, required
  - `status` 'matched' | 'not_found', required
  - `data` object[], required
    - `person_id` string
    - `full_name` string
    - `first_name` string
    - `last_name` string
    - `role` string
    - `seniority` string[]
    - `departments` string[]
    - `linkedin_url` string, uri
    - `location` string
    - `country` string
    - `company_id` string
    - `company_name` string
    - `company_website` string
    - `company_linkedin_url` 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)