Build a RIS Case Law API Request — ris_req_case

Construct an httr2_request object for the Austrian RIS OGD REST API v2.6 /Judikatur endpoint. The request is not executed; call ris_perform_case_law() to send it and parse the results, or use httr2::req_dry_run() to inspect the URL.

Usage

ris_req_case_law(
  application,
  query = NULL,
  business_number = NULL,
  norm = NULL,
  decision_date_from = NULL,
  decision_date_to = NULL,
  decision_type = NULL,
  index_term = NULL,
  collection_number = NULL,
  title = NULL,
  document_kind = NULL,
  publication_organ = NULL,
  legal_area = NULL,
  specialist_area = NULL,
  court = NULL,
  legal_principle_number = NULL,
  legal_assessment = NULL,
  ruling = NULL,
  citation = NULL,
  changed_since_period = NULL,
  federal_state = NULL,
  deciding_authority = NULL,
  commission = NULL,
  senate = NULL,
  discrimination_ground = NULL,
  author = NULL,
  short_title = NULL,
  domain = NULL,
  in_ris_since = NULL,
  search_decision_text = NULL,
  search_legal_principles = NULL,
  base_url = "https://data.bka.gv.at/ris/api/v2.6"
)

Arguments

application

Judikatur application. Accepts RIS codes or English aliases (case-insensitive):

Code	English Alias	Court / Body
`"Vfgh"`	`"constitutional_court"`	Constitutional Court (VfGH)
`"Vwgh"`	`"administrative_court"`	Supreme Administrative Court (VwGH)
`"Justiz"`	`"justice"`	Ordinary courts (OGH, OLG, LG, BG, OPMS, AUSL)
`"Bvwg"`	`"federal_administrative_court"`	Federal Administrative Court (BVwG)
`"Lvwg"`	`"state_administrative_courts"`	State Administrative Courts (LVwG)
`"Normenliste"`	`"norm_list"`	VwGH Norm List
`"Dsk"`	`"data_protection_authority"`	Data protection authorities (DSK/DSB/PDK)
`"Dok"`	`"disciplinary_bodies"`	Federal Disciplinary Authority & commissions
`"Pvak"`	`"staff_representation_oversight"`	Staff Representation Oversight Authority
`"Gbk"`	`"equal_treatment_commission"`	Equal Treatment Commissions (since 2014)
`"Uvs"`	`"independent_administrative_panels"`	Independent Administrative Panels (1991–2013)
`"AsylGH"`	`"asylum_court"`	Asylum Court (2008–2013)
`"Ubas"`	`"independent_federal_asylum_panel"`	Independent Federal Asylum Panel (1998–2008)
`"Umse"`	`"environmental_panel"`	Environmental Panel (1994–2013)
`"Bks"`	`"federal_communications_panel"`	Federal Communications Panel (2001–2013)
`"Verg"`	`"procurement_review_bodies"`	Procurement Review Bodies (until 2013)

query

Optional full-text query (Suchworte).

business_number

Optional business number (Geschaeftszahl).

norm

Optional legal norm query (Norm).

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). Allowed values depend on application:

VfGH: "Undefined", "Beschluss", "Erkenntnis", "Vergleich", "KeineAngabe" (English aliases: "order", "judgment", "settlement", "not_specified").
VwGH: "Undefined", "Beschluss", "Erkenntnis", "BeschlussVS", "ErkenntnisVS".
BVwG: "Undefined", "Beschluss", "Erkenntnis".
LVwG / UVS: "Undefined", "Beschluss", "Erkenntnis", "Bescheid".
Justiz: "Ordentliche Erledigung (Sachentscheidung)", "Zurückweisung mangels erheblicher Rechtsfrage", "Zurückweisung aus anderen Gründen", "Verstärkter Senat".
AsylGH: "Undefined", "Beschluss", "Erkenntnis", "ErkenntnisGrundsatzentscheidung", "ErkenntnisVerstaerkterSenat", "Bescheid".
Ubas: "Undefined", "Bescheid", "Ersatzbescheid".
Gbk: "Undefined", "Einzelfallpruefungsergebnis", "Gutachten".
Dsk: "Undefined", "BescheidBeschwerde", "BescheidAmtswegigesPruefverfahren", "VerwaltungsstraferkenntnisVerwarnungErmahnung", "BescheidWissenschaftStatistikArchiv", "BescheidInternatDatenverkehr", "BescheidAkkreditierungZertifizierung", "BescheidVerhaltensregeln", "BescheidWarnung", "BescheidRegistrierung", "BescheidSonstiger", "Empfehlung", "BescheidIFG", "Verfahrensschriftsaetze".

Values for VfGH, VwGH, BVwG, LVwG, Justiz, Dsk, and Gbk are validated client-side. Values for all other applications (including AsylGH and Ubas) are passed to the API as-is and validated server-side only.

index_term

Optional index term (Index).

collection_number

Optional collection number (Sammlungsnummer).

title

Optional title (Titel), used for Normenliste.

document_kind

Optional document kind (Typ), used for Normenliste.

publication_organ

Optional publication organ (Kundmachungsorgan), used for Normenliste.

legal_area

Optional legal area (Rechtsgebiet), used for Justiz.

specialist_area

Optional specialist area (Fachgebiet), used for Justiz.

court

Optional court (Gericht), used for Justiz.

legal_principle_number

Optional legal principle number (Rechtssatznummer), used for Justiz.

legal_assessment

Optional legal assessment (RechtlicheBeurteilung), used for Justiz.

ruling

Optional ruling text (Spruch), used for Justiz and Ubas.

citation

Optional citation (Fundstelle), used for Justiz.

changed_since_period

Optional change window (AenderungenSeitPeriode), used for Justiz.

federal_state

Optional federal state (Bundesland), used for Lvwg and Uvs.

deciding_authority

Optional deciding authority (EntscheidendeBehoerde), used for Dsk, Dok, Pvak, Verg.

commission

Optional commission (Kommission), used for Gbk.

senate

Optional senate (Senat), used for Gbk.

discrimination_ground

Optional discrimination ground (Diskriminierungsgrund), used for Gbk.

author

Optional author (Verfasser), used for Ubas.

short_title

Optional short title (Kurzbezeichnung), used for Umse.

domain

Optional domain (Bereich), used for Bks.

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).

search_legal_principles

Optional flag for legal principles search (SucheInRechtssaetzen).

base_url

API base URL.

Value

An httr2_request object with an additional "ris_meta" attribute containing the application code and website URLs. Pass this to ris_perform_case_law() to execute the search.

Examples

if (FALSE) { # \dontrun{
# Build request, then inspect the URL without hitting the network
req <- ris_req_case_law(
  application = "constitutional_court",
  query = "Grundrecht"
)
httr2::req_dry_run(req)

# Execute
results <- ris_perform_case_law(req)
} # }