# Search agreements with matched section previews

`GET /v1/search/agreements`

Operation ID: `searchAgreements`
Tags: agreements_search

Searches agreements with the same structured filters as `/v1/sections`, including taxonomy IDs, and returns one row per agreement.

## Query parameters

- `year` — array<integer>; default: []
  Agreement year filter. Repeat query key for multiple values.
- `year_min` — integer; min: 1900; max: 2100; nullable
- `year_max` — integer; min: 1900; max: 2100; nullable
- `target` — array<string>; default: []
  Exact target company names to include.
- `acquirer` — array<string>; default: []
  Exact acquirer company names to include.
- `standard_id` — array<string>; default: []
  Clause type taxonomy standard IDs (Clause Type in the Search UI). Parent IDs expand to include descendant taxonomy nodes.
- `transaction_price_total` — array<string>; default: []
- `transaction_price_stock` — array<string>; default: []
- `transaction_price_cash` — array<string>; default: []
- `transaction_price_assets` — array<string>; default: []
- `transaction_consideration` — array<string>; default: []
- `target_type` — array<string>; default: []
- `acquirer_type` — array<string>; default: []
- `target_counsel` — array<string>; default: []
- `acquirer_counsel` — array<string>; default: []
- `target_industry` — array<string>; default: []
- `acquirer_industry` — array<string>; default: []
- `deal_status` — array<string>; default: []
- `attitude` — array<string>; default: []
- `deal_type` — array<string>; default: []
- `purpose` — array<string>; default: []
- `target_pe` — array<string>; default: []
- `acquirer_pe` — array<string>; default: []
- `metadata` — array<string>; default: []
  Additional agreement metadata fields to include in each result under `results[].metadata`. Repeat query key for multiple values.
- `agreement_uuid` — string; nullable
  Filter to one agreement UUID.
- `section_uuid` — string; nullable
  Filter to one section UUID.
- `count_mode` — string; enum: auto, exact; default: "auto"
  Count strategy for pagination planning. `auto` may return estimates for broad or paginated searches; `exact` forces an exact total count.
- `sort_by` — string; enum: year, target, acquirer; default: "year"
  Sort key. One of: `year`, `target`, `acquirer`.
- `sort_direction` — string; enum: asc, desc; default: "desc"
  Sort direction. One of: `asc`, `desc`.
- `page` — integer; default: 1
  1-based page number.
- `page_size` — integer; default: 25
  Page size. Effective max is 10 for unauthenticated callers and 100 for authenticated callers.
- `include_dump` — boolean; default: true
  When false, omit `dump_version` from the response body. The `X-Pandects-Dump-Hash` response header is always included.
- `include_xml` — boolean; default: false
  Deprecated compatibility parameter. Section search results include section XML for all callers.

## Responses

### 200

OK

Content-Type: `application/json`

```json
{
  "$ref": "#/components/schemas/AgreementSearchResponse"
}
```

### 422

### default