---
title: "Search contacts for a company"
method: POST
path: "/companies/{company_id}/contacts/search"
tags: ["companies"]
---

# Search contacts for a company

`POST /companies/{company_id}/contacts/search`

## Request

- Base URL: `https://api.getpg.ai/public-api/v1`
- URL: `https://api.getpg.ai/public-api/v1/companies/{company_id}/contacts/search`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/getpg/apis/pg-ai-public-api/docs/companies/:company_id/contacts/search/post.ts> (a function with typed inputs; its response is checked against the schema)

Per-company contact search. Append ?live=true to force a live refresh (returns 202 when async).

## Path parameters

- `company_id` string, required

## Query parameters

- `live` 'true' | 'false'

## Request body

- object

## Response `200`

Success (cached)

- object: Response data

## Other responses

- `202`: Accepted (live refresh)
- `401`: Unauthorized
- `402`: Insufficient credits
- `500`: Unexpected error

---

[API](https://skmtc.dev/getpg/apis/pg-ai-public-api.md) - [All operations](https://skmtc.dev/getpg/apis/pg-ai-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getpg/apis/pg-ai-public-api/revisions/cc47d013c073?raw)