# Search case law

> Find decisions by provision, case number or ECLI; holdings, headnotes and decision text.

<!-- html: https://lexomat.sk/en/doc/search-case-law · sk: https://lexomat.sk/doc/search-case-law.md · index: https://lexomat.sk/llms.txt -->
## What it does

`search_case_law` finds court decisions by a **provision address** (an act and, optionally, a section), by an **ECLI** or **case number**, or — only when you ask for it explicitly — across the **whole index**. Results come back in labelled evidence groups; each group has its own status, its own coverage statement and its own failure.

Three groups are served:

- **`holdings`**: the generalized rule a decision applied (a paraphrase), beside the court's own verbatim passage. Holdings cover only part of the decisions.
- **`headnotes`**: ask for it in `evidence_types` (with `whole_index`) to also get the published legal sentences (_právne vety_) of Zbierka R and Zbierka NSS, each labelled with its Zbierka identifier.
- **`judgment_text`**: a search in the text of decisions across the **whole index**, decisions without a holding included (whole-index mode only). A result names the decision (case number, ECLI, court, link, court tier); it carries no paraphrase and no quoted passage.

With `whole_index` and no `evidence_types`, `holdings` and `judgment_text` run, as two separate rankings; a decision that appears in both is linked by `holdings_rank`. At an address or an identifier the default is `holdings`. Asking for only groups that cannot run is refused.

Like every tool in this connector, it is **read-only** and its output is **informational, not legal advice**.

## Inputs

| Name                                                   | Type    | Description                                                                                                                                          |
| ------------------------------------------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `address`                                              | object  | `{act, section?}`: the act as a collection number (`40/1964 Zb.`), id or full name, and a section (`420`, `čl. 20`). A bare abbreviation is refused. |
| `ecli`, `case_file_number`                             | string  | Exact lookup; may return several decisions. Send one, not both.                                                                                      |
| `whole_index`                                          | boolean | Explicit opt-in to search without an address or identifier. **Requires `question`.**                                                                 |
| `question`                                             | string  | The legal question. It ranks the selected set; on its own it does not decide what is searched.                                                       |
| `court`, `jurisdictions`, `decided_from`, `decided_to` | —       | Hard filters. The dates bound the **publication** date, not the decision date.                                                                       |
| `judge`, `decision_form`                               | string  | Hard filters for Slovak general courts only; the response states how many candidate sources each could be applied to.                                |
| `centrality`, `treatment`                              | —       | `core` (default at an address) or `any`; the court's interpretive operation (not whether the view is still valid).                                   |
| `evidence_types`                                       | array   | Default `["holdings"]`; with `whole_index`, `["holdings", "judgment_text"]`. `headnotes` runs only when named.                                       |
| `sort`                                                 | string  | `relevance` (default; with no question, newest-published first), `authority` (court tier, then relevance) or `published` (publication date).         |
| `limit`                                                | integer | 1 to 20 per group. A value outside the range is refused, not clamped.                                                                                |

## Returns

A `groups` object, one entry per requested group, each with `status` (`ok`, `empty` or `failed`), `results`, `total` and `total_kind`, `total_concurring` (decisions in the matched set before truncation, **not** the number that agree), `coverage` and, when it failed, `failure`. A holdings result carries the `decision` (with `published_at`, the publication date), the `holding` paraphrase, the verbatim `evidence.passage` and the `provisions` it operates on. A judgment_text result carries the `decision`, a `title` (an SD EÚ Advocate General's opinion or order is named as such) and `authority.court_tier`; `decision.text_available: false` marks a decision held as metadata only. A signed `receipt` covers the decisions returned.

## Notes

- **`holding_text` is a paraphrase** — only `evidence.passage` is the court's wording.
- `coverage` carries no figures in this version. **An empty result means "nothing in this index"**, not that no court has ruled.
- `sort: published` and `published_at` are publication dates; the decision date is not stored for most decisions.
- `judgment_text` and `headnotes` apply the `jurisdictions` filter only (`headnotes` holds the Slovak collections only). With `court`, `judge`, `decision_form`, a date filter, `treatment` or an explicitly sent `centrality`, such a group is not searched rather than ignoring the filter: `judgment_text` as a default group is skipped (named in `groups_skipped`), and a group you ask for in `evidence_types` is refused (`GROUP_UNAVAILABLE`).
- No generative model is involved (a query embedding and a reranker rank the text search). A whole-index call can take up to 8 s. Debits the **corpus** quota once per call, however many groups run (see **Usage limits**); a call refused before processing does not.
