Search case law

    search_case_law

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

    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

    NameTypeDescription
    addressobject{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_numberstringExact lookup; may return several decisions. Send one, not both.
    whole_indexbooleanExplicit opt-in to search without an address or identifier. Requires question.
    questionstringThe 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_formstringHard 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_typesarrayDefault ["holdings"]; with whole_index, ["holdings", "judgment_text"]. headnotes runs only when named.
    sortstringrelevance (default; with no question, newest-published first), authority (court tier, then relevance) or published (publication date).
    limitinteger1 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.