# Search Index

> Search canonical indexed deal facts and their source documents in the Lev API.

Source: https://www.lev.com/docs/build/index/search

Last updated: 2026-09-16

---
### `POST /api/external/v2/deals/{deal_id}/index/search`

Search canonical indexed deal facts by natural-language context

#### Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `deal_id` | `integer` | Yes | The deal ID |

#### Request Body

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `context` | `string` | Yes | Natural-language search context (1-4000 characters). Be specific about the metric or topic you want. |
| `min_score` | `number` | No | Minimum similarity threshold from 0 to 1. Defaults to 0.3. |
| `limit` | `integer` | No | Maximum ranked facts to return. Defaults to 20 and is clamped to 1-200. |
| `include_signed_urls` | `boolean` | No | When true, document-backed source records may include short-lived signed URLs for inspection or download. |

Response: `200`

#### Error Responses

- **422** (validation_error): context must not be blank
- **401** (unauthorized): Authentication required
- **404** (not_found): Deal not found
- **503** (service_unavailable): Deal data search is temporarily unavailable. Try again shortly.