---
title: "Filter and list analyzed deals"
method: POST
path: "/tools/select-deal"
tags: ["Tools"]
---

# Filter and list analyzed deals

`POST /tools/select-deal`

## Request

- Base URL: `https://app.usehindsight.com/api/v1`
- URL: `https://app.usehindsight.com/api/v1/tools/select-deal`
- Auth: HTTP bearer

Returns lean, paginated deal rows for triage. Use `get-deal` to retrieve the full details for returned deal IDs.

## Request body

- SelectDealRequest
  - `query` string, nullable: Fuzzy deal or client-name match. Cannot be used with semantic_query or segment_id.
  - `semantic_query` string, nullable: Conceptual search over deal content. Cannot be used with query or segment_id.
  - `segment_id` string, nullable: Segment ID. Cannot be used with query.
  - `competitor_id` string, nullable
  - `deal_stage` union: One or more deal-stage names.
    - string
    - string[]
  - `amount` object, nullable
    - `min` number, nullable
    - `max` number, nullable
  - `close_date` object, nullable
    - `from` string, nullable
    - `to` string, nullable
  - `type` string, nullable
  - `region` string, nullable
  - `owner_name` string, nullable: Owner name, email, or `me`, `my`, or `mine`.
  - `limit` integer
  - `page` integer

## Response `200`

Matching deal rows

- SelectDealResponse
  - `total_returned` integer
  - `limit_applied` integer, nullable
  - `page` integer
  - `page_size` integer
  - `has_more` boolean
  - `next_page` integer, nullable
  - `results` DealToolRow[]
    - `type` string
    - `id` string, nullable
    - `deal_id` string, nullable
    - `name` string, nullable
    - `client_name` string, nullable
    - `stage` string, nullable
    - `amount` number, nullable
    - `close_date` string, nullable
    - `url` string, nullable

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - invalid or missing API key
- `403`: Forbidden - the API key's role cannot use this tool
- `429`: Too many requests - rate limit or applicable usage quota exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/usehindsight/apis/hindsight-api.md) - [All operations](https://skmtc.dev/usehindsight/apis/hindsight-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usehindsight/apis/hindsight-api/revisions/97371a7da857?raw)