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

# Search deals

`POST /v2/api/crm/deals/search`

Search and filter deals in your CRM.

## Request body

- SearchDealsRequest — Request body for searching deals
  - `filters` object, nullable — Named filters. Combined with AND.
    - `stage` string — Filter by deal stage/status (exact match)
  - `search` string, nullable — Free-text search across deal name 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` CrmDeal[]
    - `id` string — Unique deal identifier
    - `name` string — Deal name
    - `status` string, nullable — Current deal status
    - `amount` number, nullable — Deal monetary value
    - `currency` string, nullable — Three-letter ISO 4217 currency code
    - `closed_at` string, date-time, nullable — When the deal was closed (ISO 8601)
    - `company` CrmCompanyRef, nullable — Embedded company reference
      - `id` string — Company ID
      - `name` string — Company name
    - `created_at` string, date-time — When the deal was created
    - `updated_at` string, date-time — When the deal 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)