> ## Documentation Index > Fetch the complete documentation index at: https://help.withallo.com/llms.txt > Use this file to discover all available pages before exploring further. # Search people > Search and filter people in your CRM with advanced filtering, sorting, and pagination. **Required scope:** `CRM_READ` This endpoint is paginated. Use `page` and `size` in the request body to control results. See [Pagination](/en/v2/api-reference/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 theme={null} { "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 | ## OpenAPI ````yaml POST /v2/api/crm/people/search openapi: 3.0.3 info: title: Allo API description: >- Allo API provides programmatic access to your Allo account, allowing you to manage webhooks, retrieve calls and contacts, and send SMS messages. All requests to `/v1/api/**` endpoints automatically go through quota checking and scope validation. version: 1.0.0 contact: name: Allo Support servers: - url: https://api.withallo.com description: Production server security: [] tags: - name: Summary Templates description: >- Manage call summary templates that control how AI-generated call summaries are structured for your team. - name: Webhooks description: >- Manage webhook endpoints to receive real-time notifications about events in your Allo account. Each endpoint subscribes to one or more event topics and is verified with a signing secret. - name: Calls description: >- Retrieve and search call records with filtering and pagination. Filter calls by your Allo phone number. - name: Contacts description: >- Search and retrieve contact information with sorting and pagination. Includes engagement level tracking. - name: SMS description: Send SMS messages to phone numbers using your Allo numbers. - name: Phone Numbers description: Retrieve information about your Allo phone numbers. - name: Analytics description: Pre-computed call metrics, team performance, and outbound dial funnel - name: CRM description: Manage people, companies, and deals in your CRM. paths: /v2/api/crm/people/search: post: tags: - CRM summary: Search people description: >- Search and filter people in your CRM with advanced filtering, sorting, and pagination. operationId: searchPeople requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SearchPeopleRequest' example: filters: job_title: engineer company: Acme sort: NAME_ASC page: 1 size: 20 responses: '200': description: Search results content: application/json: schema: allOf: - type: object properties: data: type: array items: $ref: '#/components/schemas/CrmPerson' - $ref: '#/components/schemas/PaginatedResponse' '401': $ref: '#/components/responses/ApiUnauthorized' '422': $ref: '#/components/responses/ApiValidationError' '429': $ref: '#/components/responses/ApiRateLimited' security: - ApiKeyAuth: [] components: schemas: SearchPeopleRequest: type: object description: Request body for searching people properties: filters: type: object nullable: true description: Named filters. All are combined with AND. properties: name: type: string description: Filter by first name (contains) last_name: type: string description: Filter by last name (contains) job_title: type: string description: Filter by job title (contains) website: type: string description: Filter by website (contains) company: type: string description: Filter by company name (contains) phone_number: type: string description: Filter by phone number (exact match) email: type: string description: Filter by email (contains) deal_status: type: string description: Filter by deal status (exact match) search: type: string nullable: true description: Free-text search across name, email, phone number, and company sort: type: string nullable: true enum: - DATE_DESC - DATE_ASC - NAME_ASC - NAME_DESC - CREATED_DESC - CREATED_ASC description: 'Sort order (default: DATE_DESC)' page: type: integer default: 1 description: Page number (1-indexed) size: type: integer default: 20 maximum: 100 description: Results per page CrmPerson: type: object description: A person in the CRM properties: id: type: string description: Unique person identifier example: per-abc123 name: type: string nullable: true description: First name example: John last_name: type: string nullable: true description: Last name example: Doe job_title: type: string nullable: true description: Job title example: CEO website: type: string nullable: true description: Website URL example: https://example.com address: type: string nullable: true description: Postal address example: 123 Main St numbers: type: array items: type: string description: Phone numbers in E.164 format example: - '+33612345678' emails: type: array items: type: string description: Email addresses example: - john@example.com company: $ref: '#/components/schemas/CrmCompanyRef' interactions: type: integer description: Total number of interactions (calls + messages) example: 5 last_activity_at: type: string format: date-time nullable: true description: Timestamp of the last activity example: '2026-04-28T10:30:00' created_at: type: string format: date-time description: When the person was created example: '2026-04-01T09:00:00' updated_at: type: string format: date-time description: When the person was last updated example: '2026-04-28T10:30:00' PaginatedResponse: type: object properties: pagination: $ref: '#/components/schemas/Pagination' CrmCompanyRef: type: object nullable: true description: Embedded company reference properties: id: type: string description: Company ID example: com-xyz789 name: type: string description: Company name example: Acme Corp Pagination: type: object properties: page: type: integer size: type: integer total_count: type: integer total_pages: type: integer has_more: type: boolean ApiError: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string retryable: type: boolean request_id: type: string retry_after_seconds: type: integer nullable: true responses: ApiUnauthorized: description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiValidationError: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiRateLimited: description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ApiError' securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization ````