# Search companies

> Search and filter companies in your CRM.

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

<Note>
**Required scope:** `CRM_READ`
</Note>

This endpoint is paginated. Use `page` and `size` in the request body to control results. See [Pagination](/docs/guides/pagination).

## Request body

| Field | Type | Description |
|-------|------|-------------|
| `filters` | object | Named filters (see below) |
| `sort` | string | Sort order: `DATE_DESC`, `DATE_ASC`, `NAME_ASC`, `NAME_DESC`, `CREATED_DESC`, `CREATED_ASC` |
| `page` | integer | Page number (1-indexed) |
| `size` | integer | Results per page (max 100) |

## Filters

Pass an object with named fields. All provided filters are combined with AND.

```json
{
  "filters": {
    "name": "Acme",
    "industry": "Technology"
  },
  "sort": "NAME_ASC",
  "page": 1,
  "size": 20
}
```

### Available filter fields

| Field | Match type | Description |
|-------|-----------|-------------|
| `name` | contains | Company name |
| `website` | contains | Website URL |
| `industry` | contains | Industry sector |

## Custom attributes

Each result includes `custom_attributes`, the values of your [company attributes](/docs/crm/create-company-attribute) keyed by attribute key. Always present, `{}` when there are none, with the same formats as [Get company](/docs/crm/get-company). Custom attributes cannot be used to filter or sort.
