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

# Search company contacts

`POST /companies/{company_id}/contacts`

## Request

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

Search and retrieve contacts associated with a specific company. Supports filtering by name, job title, location, and LinkedIn URL.

## Path parameters

- `company_id` string, required

## Request body

- object
  - `page` integer: Page number for pagination
  - `per_page` integer: Page size. Default 25, maximum 50 on all list endpoints. Omit to use the default; increase up to 50 only if you need larger pages.
  - `name` string: Filter by contact name
  - `job_title` string: Filter by job title
  - `location` string: Filter by location
  - `linkedin_url` string: Filter by LinkedIn URL

## Response `200`

Success - list of contacts with pagination

- object: Response data

## Other responses

- `400`: Invalid company ID
- `401`: Unauthorized
- `403`: Access denied. Required: contacts:read
- `404`: Company not found
- `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)