---
title: "Search companies"
method: POST
path: "/v2/api/crm/companies/search"
tags: ["CRM"]
---

# Search companies

`POST /v2/api/crm/companies/search`

Search and filter companies in your CRM.

## Request body

- SearchCompaniesRequest — Request body for searching companies
  - `filters` object, nullable — Named filters. All are combined with AND.
    - `name` string — Filter by company name (contains)
    - `website` string — Filter by website (contains)
    - `industry` string — Filter by industry (contains)
  - `sort` 'DATE_DESC' | 'DATE_ASC' | 'NAME_ASC' | 'NAME_DESC' | 'CREATED_DESC' | 'CREATED_ASC', nullable — Sort order (default: DATE_DESC)
  - `page` integer — Page number (1-indexed)
  - `size` integer — Results per page

## Response `200`

Search results

- object
  - `data` CrmCompany[]
    - `id` string — Unique company identifier
    - `name` string — Company name
    - `website` string, nullable — Company website URL
    - `industry` string, nullable — Industry sector
    - `person_count` integer — Number of people linked to this company
    - `interactions` integer — Total number of interactions across all people in this company
    - `last_activity_at` string, date-time, nullable — Timestamp of the last activity
    - `created_at` string, date-time — When the company was created
    - `updated_at` string, date-time — When the company was last updated
  - `pagination` Pagination
    - `page` integer
    - `size` integer
    - `total_count` integer
    - `total_pages` integer
    - `has_more` boolean

## Other responses

- `401` — Invalid or missing API key
- `422` — Invalid request parameters
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) · [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withallo/allo-api/revisions/9aab4db82933/schema)