# Search people

> Search and filter people in your CRM with advanced filtering, sorting, and pagination.

`POST /v2/api/crm/people/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 person fields |
| `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": {
    "job_title": "engineer",
    "company": "Acme"
  },
  "sort": "NAME_ASC",
  "page": 1,
  "size": 20
}
```

### Available filter fields

| Field | Match type | Description |
|-------|-----------|-------------|
| `name` | contains | First name |
| `last_name` | contains | Last name |
| `job_title` | contains | Job title |
| `website` | contains | Website URL |
| `company` | contains | Company name |
| `phone_number` | exact | Phone number |
| `email` | contains | Email address |
| `deal_status` | exact | Deal status |

## Custom attributes

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