---
title: "Search Deals"
method: GET
path: "/api/deals/search"
tags: ["deals"]
---

# Search Deals

`GET /api/deals/search`

## Request

- Base URL: `https://api.electricair.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.electricair.io/api/deals/search`
- Auth: none declared

## Query parameters

- `q` string
- `page` integer
- `page_size` integer
- `saved_filter_id` integer, nullable
- `stage` string, nullable
- `status` string, nullable
- `date_from` string, nullable
- `date_to` string, nullable
- `date_preset` string, nullable
- `assigned_salesperson_id` integer, nullable
- `label` string, nullable
- `unlabeled` boolean
- `sort_by` string, nullable
- `sort_dir` string, nullable

## Response `200`

OK

- DealListResponseSchema
  - `items` DealListItemSchema[], required
    - `id` integer, required
    - `address` string, required
    - `customer_name` string, required
    - `city` string, nullable
    - `region` string, nullable
    - `stage` string, nullable
    - `status` string, nullable
    - `pipedrive_sync_attention_required` boolean
    - `pipedrive_sync_attention_reason` string
    - `needs_response` boolean
    - `needs_response_channels` string[]
    - `needs_response_since` string, nullable
    - `salesperson_id` integer, nullable
    - `salesperson_name` string, nullable
    - `created_at` string, nullable
    - `last_action_at` string, nullable
    - `last_customer_action_at` string, nullable
    - `last_team_action_at` string, nullable
    - `won_time` string, nullable
    - `closed_time` string, nullable
    - `referral` string, nullable
    - `deal_size` number, nullable
    - `proposal_uuid` string, nullable
    - `quote_count` integer, required
    - `custom_field_values` object
    - `labels` DealLabelSchema[]
      - `id` integer, required
      - `name` string, required
      - `color` string, required
      - `is_active` boolean, required
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `total_pages` integer, required

## Changes

> 22 revisions in range; 1 not diffed.

- **2026-09-17** `1979433dd6f0`: 3 info
  - added the optional property `items/items/last_action_at` to the response with the `200` status
  - added the optional property `items/items/last_customer_action_at` to the response with the `200` status
  - added the optional property `items/items/last_team_action_at` to the response with the `200` status
- **2026-09-02** `631c00db4944`: 3 info
  - added the optional property `items/items/needs_response` to the response with the `200` status
  - added the optional property `items/items/needs_response_channels` to the response with the `200` status
  - added the optional property `items/items/needs_response_since` to the response with the `200` status

[Operation history](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/changes/api/deals/search/get.md)

---

[API](https://skmtc.dev/electricair/apis/electric-air-autoquote-api.md) - [All operations](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/llms.txt) - [OpenAPI document](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/revisions/a13d832a5676?raw)