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 inevidence_types(withwhole_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_textis a paraphrase — onlyevidence.passageis the court's wording.coveragecarries no figures in this version. An empty result means "nothing in this index", not that no court has ruled.sort: publishedandpublished_atare publication dates; the decision date is not stored for most decisions.judgment_textandheadnotesapply thejurisdictionsfilter only (headnotesholds the Slovak collections only). Withcourt,judge,decision_form, a date filter,treatmentor an explicitly sentcentrality, such a group is not searched rather than ignoring the filter:judgment_textas a default group is skipped (named ingroups_skipped), and a group you ask for inevidence_typesis 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.