Skip to contents

Search Justiz Decisions in RIS

Source: R/ris_search_justiz.R
ris_search_justiz.Rd

Convenience wrapper around ris_search_case_law() with application = "Justiz".

Usage

ris_search_justiz(
  query = NULL,
  business_number = NULL,
  norm = NULL,
  decision_date_from = NULL,
  decision_date_to = NULL,
  decision_type = NULL,
  index_term = NULL,
  legal_area = NULL,
  specialist_area = NULL,
  court = NULL,
  legal_principle_number = NULL,
  legal_assessment = NULL,
  ruling = NULL,
  citation = NULL,
  changed_since_period = NULL,
  in_ris_since = NULL,
  search_decision_text = TRUE,
  search_legal_principles = TRUE,
  echo = FALSE,
  base_url = ris_base_url()
)

Arguments

query

Optional full-text query (Suchworte). Supports the RIS full-text operators (space/und = AND, OR/ODER = OR, nicht = NOT, * = wildcard, 'phrase' for exact phrase).

business_number

Optional business number (Geschaeftszahl).

norm

Optional legal norm query (Norm). Multiple norms can be combined with OR/ODER (wrap each norm in single quotes, e.g. "'AsylG 2005 §3' ODER 'BFA-VG §21 Abs7'").

decision_date_from

Optional lower date bound (YYYY-MM-DD, EntscheidungsdatumVon).

decision_date_to

Optional upper date bound (YYYY-MM-DD, EntscheidungsdatumBis).

decision_type

Optional decision type (Entscheidungsart). Justiz accepts (pass the string exactly as shown): "Ordentliche Erledigung (Sachentscheidung)", "Zurückweisung mangels erheblicher Rechtsfrage", "Zurückweisung aus anderen Gründen", "Verstärkter Senat".

index_term

Optional index term (Index).

Optional legal area filter (Rechtsgebiet), e.g. "Zivilrecht" or "Strafrecht".

specialist_area

Optional specialist area (Fachgebiet), e.g. "Arbeitsrecht" or "Mietrecht".

court

Optional court name (Gericht), e.g. "OGH", "OLG Wien".

Optional legal principle number (Rechtssatznummer), e.g. "0000001".

Optional legal assessment text (RechtlicheBeurteilung).

ruling

Optional ruling text (Spruch).

citation

Optional citation reference (Fundstelle), e.g. "SZ 75/123".

changed_since_period

Optional time window for changes (AenderungenSeitPeriode). Same interval keywords as in_ris_since.

in_ris_since

Optional RIS recency filter (ImRisSeit). Accepts API values ("Undefined", "EinerWoche", "ZweiWochen", "EinemMonat", "DreiMonaten", "SechsMonaten", "EinemJahr") and English aliases ("one_week", "two_weeks", "one_month", "three_months", "six_months", "one_year").

search_decision_text

Optional flag for decision text search (SucheInEntscheidungstexten).

Optional flag for legal principles search (SucheInRechtssaetzen). When both flags are omitted, both document types are searched. When only one flag is given, the other defaults to its complement, so a single flag selects exactly one document type (e.g. search_decision_text = FALSE searches legal principles only). Setting both to FALSE is an error.

echo

Logical. If TRUE, prints two progress messages: the equivalent RIS website search URL (the Ergebnis.wxe query on https://www.ris.bka.gv.at) before any request is sent; and the total hit and page count as soon as the first page's response arrives. This lets the result set be double-checked in the browser and gives an early sense of scope for broad queries without waiting for every page.

base_url

API base URL. Defaults to ris_base_url(), which can be overridden for a session via options(risAT.base_url = ...).

Value

A tidy tibble with parsed search results. Includes list-column content_urls.

Details

Covers decisions from the Oberster Gerichtshof (OGH), Oberlandesgerichte (OLG), Landesgerichte (LG), Bezirksgerichte (BG), Oberster Patent- und Markensenat (OPMS, until 2013), and selected foreign decisions (AUSL).

Examples

if (FALSE) { # interactive()
# Keyword search across decision texts and Rechtssaetze (default).
# The query field supports full-text operators: space/"und" = AND,
# "OR"/"ODER" = OR, "nicht" = NOT, * = wildcard, 'phrase' for exact phrase.
ris_search_justiz(query = "Schadenersatz")

# Filter to OGH decisions only
ris_search_justiz(query = "Schadenersatz", court = "OGH")

# Filter by legal area and date range
ris_search_justiz(
  legal_area = "Zivilrecht",
  decision_date_from = "2022-01-01",
  decision_date_to = "2023-12-31"
)

# Search by legal principle number (Rechtssatznummer)
ris_search_justiz(legal_principle_number = "0000001")

# Search by citation (Fundstelle)
ris_search_justiz(citation = "SZ 75/123")

# Search by norm and restrict to OGH decisions in a specialist area
ris_search_justiz(
  norm = "ABGB §1295",
  specialist_area = "Schadenersatzrecht",
  court = "OGH"
)

# Look up a specific OGH case by business number
# OGH business number format: "N Ob NNN/YY" or "N Ob N/YYg" etc.
ris_search_justiz(business_number = "1Ob1/23g", echo = TRUE)
}