---
title: "Get full details for known deal IDs"
method: POST
path: "/tools/get-deal"
tags: ["Tools"]
---

# Get full details for known deal IDs

`POST /tools/get-deal`

## Request

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

Retrieves the summary and per-competitor positioning for one to ten deal IDs.

## Request body

- GetDealRequest
  - `deal_ids` string[], required

## Response `200`

Detailed deal records

- GetDealResponse
  - `total_returned` integer
  - `limit_applied` integer, nullable
  - `results` object[]
    - `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
    - `summary` string, nullable
    - `competitors` object[]
      - `name` string, nullable
      - `positioning_summary` string, nullable
      - `key_differentiators` 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)