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

# Search people

`POST /v2/api/crm/people/search`

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

## Request body

- SearchPeopleRequest — Request body for searching people
  - `filters` object, nullable — Named filters. All are combined with AND.
    - `name` string — Filter by first name (contains)
    - `last_name` string — Filter by last name (contains)
    - `job_title` string — Filter by job title (contains)
    - `website` string — Filter by website (contains)
    - `company` string — Filter by company name (contains)
    - `phone_number` string — Filter by phone number (exact match)
    - `email` string — Filter by email (contains)
    - `deal_status` string — Filter by deal status (exact match)
  - `search` string, nullable — Free-text search across name, email, phone number, and company
  - `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` CrmPerson[]
    - `id` string — Unique person identifier
    - `name` string, nullable — First name
    - `last_name` string, nullable — Last name
    - `job_title` string, nullable — Job title
    - `website` string, nullable — Website URL
    - `address` string, nullable — Postal address
    - `numbers` string[] — Phone numbers in E.164 format
    - `emails` string[] — Email addresses
    - `company` CrmCompanyRef, nullable — Embedded company reference
      - `id` string — Company ID
      - `name` string — Company name
    - `interactions` integer — Total number of interactions (calls + messages)
    - `last_activity_at` string, date-time, nullable — Timestamp of the last activity
    - `created_at` string, date-time — When the person was created
    - `updated_at` string, date-time — When the person 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)