# Search deals

> Search and filter deals in your CRM.

`POST /v2/api/crm/deals/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) |
| `search` | string | Full-text keyword search across deal name and company |
| `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

| Field | Match type | Description |
|-------|-----------|-------------|
| `stage` | exact | Deal stage/status |
