{ "openapi": "3.0.3", "info": { "title": "Judic API v2", "version": "2.0.0", "description": "Öffentliche REST-API von Judic mit durchgängig deutschen JSON-Keys.\nKeine v1-Legacy-Aliase (z. B. keyword/sg_kw, ref neben reference, language neben\nsprache). v1 bleibt unter /api/v1/ unverändert.\n\nNeben Bundesrecht (Fedlex) liefert die API kantonale Gesetzestexte —\nderzeit Zürich (ZH-Lex), Aargau (LexWork) und Schwyz (SRSZ). Fehlende\nErlasse werden on-demand im Hintergrund geholt (HTTP 202 bis bereit).\n" }, "servers": [ { "url": "https://judic.ch" }, { "url": "http://localhost:8080" } ], "tags": [ { "name": "Entscheide" }, { "name": "Gesetze", "description": "Bundeserlasse (Fedlex / SR)." }, { "name": "Kantonsgesetze", "description": "Kantonale Gesetzestexte. Derzeit Zürich (`ZH`, ZH-Lex), Aargau (`AG`, LexWork)\nund Schwyz (`SZ`, SRSZ). `gesetz_id` ist Kürzel (z. B. GOG, KV) oder\nsystematische Nummer (211.1, 110.000, 100.100). Fehlt der Text lokal, startet\nein Hintergrund-Abruf: HTTP 202 (`status: fetching`) bis der Text bereit ist,\nHTTP 502 nach gecachtem Fehlversuch, HTTP 404 wenn unbekannt.\n" }, { "name": "Bundesblatt", "description": "Fundstellen und Volltext zu einem Bundesblatt-Zitat (BBl/FF). Bis 2020\nist die gedruckte Seitenzahl keine eli-Sequenznummer; die Auflösung läuft\nüber jolux:memorialYear, jolux:memorialPage und jolux:language. Ohne\n`volltext=true` nur die angefragten Seiten (höchstens 10). Ab 2021 ist\ndie Zahl die Dokumentnummer («BBl 2023 679» = eli/fga/2023/679); gibt es\nein Fedlex-XML, wird der Text daraus gelesen statt aus dem PDF.\n" }, { "name": "Meta" }, { "name": "Übersetzung" } ], "paths": { "/api/v2/entscheide": { "get": { "summary": "Paginierte Entscheidliste", "tags": [ "Entscheide" ], "parameters": [ { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/versatz" }, { "$ref": "#/components/parameters/sortierung_entscheide" }, { "$ref": "#/components/parameters/reihenfolge" }, { "$ref": "#/components/parameters/gericht" }, { "name": "q", "in": "query", "schema": { "type": "string" }, "description": "Volltext-/Themensuche. Mehrere Woerter = UND, \"Phrase\" fuer Phrasensuche, Woort* fuer Praefixsuche, -wort fuer Ausschluss, \"a OR b\" fuer ODER. Ein darin enthaltenes Normzitat (z.B. \"Existenzminimum Art. 93 SchKG\") wird automatisch herausgeloest und als Filter auf decision_law_refs angewandt, der Rest bleibt Volltextsuche." }, { "name": "modus", "in": "query", "schema": { "type": "string", "enum": [ "volltext", "thema" ], "default": "volltext" }, "description": "Nur mit q relevant. thema sucht nur in Regeste/Gegenstand/Themen." }, { "name": "facetten", "in": "query", "schema": { "type": "string", "enum": [ "jahr" ] }, "description": "Nur mit q relevant. jahr liefert meta.facetten.jahr (Treffer je Entscheidjahr)." }, { "name": "von", "in": "query", "schema": { "type": "string", "format": "date" } }, { "name": "bis", "in": "query", "schema": { "type": "string", "format": "date" } }, { "name": "sachgebiet", "in": "query", "schema": { "type": "string" } }, { "name": "erledigung", "in": "query", "schema": { "type": "string" }, "description": "Mehrfach möglich" }, { "name": "stichwort", "in": "query", "schema": { "type": "string" }, "description": "Mehrfach möglich; matcht Sachgebiet, Themen, Abteilung" }, { "name": "sprache", "in": "query", "schema": { "type": "string", "enum": [ "DE", "FR", "IT" ] }, "description": "Mehrfach möglich" }, { "name": "richter", "in": "query", "schema": { "type": "integer", "enum": [ 1, 3, 5 ] }, "description": "Mehrfach möglich" }, { "name": "vorinstanz", "in": "query", "schema": { "type": "string" }, "description": "Gericht|Kammer, mehrfach möglich" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EntscheidListe" } } } }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/entscheid/{decision_id}": { "get": { "summary": "Vollständiger Entscheid", "tags": [ "Entscheide" ], "parameters": [ { "$ref": "#/components/parameters/entscheid_id" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Entscheid" } } } }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/entscheid/{decision_id}/metadaten": { "get": { "summary": "Entscheid ohne Volltext", "tags": [ "Entscheide" ], "parameters": [ { "$ref": "#/components/parameters/entscheid_id" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Entscheid" } } } }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/status/{decision_id}": { "get": { "summary": "Verfügbarkeitsstatus", "tags": [ "Entscheide" ], "parameters": [ { "$ref": "#/components/parameters/entscheid_id" } ], "responses": { "200": { "description": "OK" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/vorinstanzen": { "get": { "summary": "Häufigste Vorinstanzen für Filter", "tags": [ "Meta" ], "parameters": [ { "$ref": "#/components/parameters/gericht" }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 80 } }, { "name": "min_anzahl", "in": "query", "schema": { "type": "integer", "minimum": 1, "default": 1 } } ], "responses": { "200": { "description": "OK" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/statistik": { "get": { "summary": "Bestandsstatistik", "tags": [ "Meta" ], "parameters": [], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Statistik" } } } }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/taxonomie": { "get": { "summary": "Rechtsgebiets-Taxonomie", "tags": [ "Meta" ], "parameters": [], "responses": { "200": { "description": "OK" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/letzte-aktualisierung": { "get": { "summary": "Letzter Pipeline-Lauf", "tags": [ "Meta" ], "parameters": [], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LetzteAktualisierung" } } } }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/openapi.json": { "get": { "summary": "OpenAPI 3 Spezifikation (JSON)", "tags": [ "Meta" ], "parameters": [], "responses": { "200": { "description": "OK" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/openapi.yaml": { "get": { "summary": "OpenAPI 3 Spezifikation (YAML)", "tags": [ "Meta" ], "parameters": [], "responses": { "200": { "description": "OK" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/gesetz/{identifier}": { "get": { "summary": "Bundeserlass-Übersicht", "tags": [ "Gesetze" ], "parameters": [ { "$ref": "#/components/parameters/identifier" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GesetzUebersicht" } } } }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/gesetz/{identifier}/kopf": { "get": { "summary": "Gesetzeskopf (Titel/Abkürzung)", "tags": [ "Gesetze" ], "parameters": [ { "$ref": "#/components/parameters/identifier" } ], "responses": { "200": { "description": "OK" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/gesetz/{identifier}/gliederung": { "get": { "summary": "Gesetzesgliederung", "tags": [ "Gesetze" ], "parameters": [ { "$ref": "#/components/parameters/identifier" }, { "$ref": "#/components/parameters/sprache" } ], "responses": { "200": { "description": "OK" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/gesetz/{identifier}/{article}": { "get": { "summary": "Artikel-Metadaten", "tags": [ "Gesetze" ], "parameters": [ { "$ref": "#/components/parameters/identifier" }, { "$ref": "#/components/parameters/article" } ], "responses": { "200": { "description": "OK" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/gesetz/{identifier}/{article}/wortlaut": { "get": { "summary": "Artikelwortlaut", "tags": [ "Gesetze" ], "parameters": [ { "$ref": "#/components/parameters/identifier" }, { "$ref": "#/components/parameters/article" }, { "$ref": "#/components/parameters/sprache" } ], "responses": { "200": { "description": "OK" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/gesetz/{identifier}/{article}/zitiert-von": { "get": { "summary": "Zitierende Entscheide", "tags": [ "Gesetze" ], "parameters": [ { "$ref": "#/components/parameters/identifier" }, { "$ref": "#/components/parameters/article" }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/versatz" }, { "$ref": "#/components/parameters/sortierung" }, { "$ref": "#/components/parameters/reihenfolge" } ], "responses": { "200": { "description": "OK" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/gesetz/{identifier}/{article}/materialien": { "get": { "summary": "Materialien / Änderungsrefs", "tags": [ "Gesetze" ], "parameters": [ { "$ref": "#/components/parameters/identifier" }, { "$ref": "#/components/parameters/article" }, { "$ref": "#/components/parameters/sprache" } ], "responses": { "200": { "description": "OK" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/gesetz/{identifier}/{article}/kommentar": { "get": { "summary": "Kommentar", "tags": [ "Gesetze" ], "parameters": [ { "$ref": "#/components/parameters/identifier" }, { "$ref": "#/components/parameters/article" }, { "$ref": "#/components/parameters/sprache" } ], "responses": { "200": { "description": "OK" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/gesetz/{identifier}/{article}/historie": { "get": { "summary": "Artikelhistorie", "tags": [ "Gesetze" ], "parameters": [ { "$ref": "#/components/parameters/identifier" }, { "$ref": "#/components/parameters/article" } ], "responses": { "200": { "description": "OK" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/gesetz/{identifier}/{article}/leitentscheide": { "get": { "summary": "Leitentscheide", "description": "`leitentscheide_ocl`: Liste von OpenCaseLaw (meistzitierte Entscheide).\n`leitentscheide_judic`: eigene Zitieranalyse ohne KI. BGE, die deutlich\nhäufiger als üblich zusammen mit dem Artikel zitiert werden oder deren\nRegeste den Artikel nennt; nächtlich neu berechnet. Felder u. a.\n`zitierung` (BGE/ATF/DTF je nach `sprache`), `zitiert_mit_artikel`,\n`regeste_nennt_artikel`, `praxis` (`aenderung`, `praezisierung` oder\nnull) und `auch_bei_ocl`. `leitentscheide_eigene`: neueste Entscheide,\ndie den Artikel zitieren.\n", "tags": [ "Gesetze" ], "parameters": [ { "$ref": "#/components/parameters/identifier" }, { "$ref": "#/components/parameters/article" }, { "$ref": "#/components/parameters/sprache" } ], "responses": { "200": { "description": "OK" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/aenderungs-ref": { "get": { "summary": "AS/BBl → Fedlex-URL", "tags": [ "Gesetze" ], "parameters": [ { "name": "typ", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "AS", "BBl" ] } }, { "name": "jahr", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "seite", "in": "query", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "OK" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/bbl/{jahr}/{seite}": { "get": { "summary": "Fundstelle(n) eines Bundesblatt-Zitats", "description": "`seite` darf jede Seite innerhalb eines Dokuments sein, nicht nur\ndessen Anfangsseite — das umschliessende Dokument wird automatisch\ngefunden. Ohne `volltext=true` liefert die Antwort nur die Seite(n)\n`seite`..`bis` (max. 10), nicht das ganze, oft sehr lange Dokument.\n\nAb Jahrgang 2021 ist `seite` die Dokumentnummer (z. B. `/api/v2/bbl/2023/679`).\nMit Fedlex-XML (`quelle: xml`) liefert die Antwort `gliederung` und einen\n`abschnitt` (Vorgabe: Einleitung mit Übersicht), gewählt mit `ziffer`\nund bei langen Abschnitten `teil`; das XML kennt keine Seitenzählung.\nOhne XML (`quelle: pdf`, v. a. 2021/2022) wählen `dokumentseite` und\n`bis` Seiten der dokumentinternen Zählung (1..N).\n", "tags": [ "Bundesblatt" ], "parameters": [ { "$ref": "#/components/parameters/bbl_jahr" }, { "$ref": "#/components/parameters/bbl_seite" }, { "$ref": "#/components/parameters/sprache" }, { "name": "bis", "in": "query", "schema": { "type": "integer" }, "description": "Letzte Seite des Bereichs (inklusive); Vorgabe = seite, max. 10 Seiten ab seite. Ab 2021 (nur PDF) letzte Dokumentseite ab dokumentseite." }, { "name": "ziffer", "in": "query", "schema": { "type": "string" }, "description": "Ab 2021, Dokumente mit XML. Ziffer (5.2), Artikel (Art. 3) oder Titel eines Abschnitts aus `gliederung`; Vorgabe = Einleitung." }, { "name": "teil", "in": "query", "schema": { "type": "integer", "minimum": 1, "default": 1 }, "description": "Ab 2021, Dokumente mit XML. Teil eines langen Abschnitts (max. 30'000 Zeichen pro Teil); die Antwort nennt `abschnitt.teile`." }, { "name": "dokumentseite", "in": "query", "schema": { "type": "integer", "minimum": 1, "default": 1 }, "description": "Ab 2021, Dokumente ohne XML. Seite in der dokumentinternen Zählung, z. B. 12 für «BBl 2021 976 S. 12»." }, { "name": "anfangsseite", "in": "query", "schema": { "type": "integer" }, "description": "Plausibilitätsprüfung gegen die zitierte Dokument-Anfangsseite; Antwort erhält anfangsseite_passt." }, { "name": "volltext", "in": "query", "schema": { "type": "boolean", "default": false }, "description": "true liefert das ganze Dokument (text + seiten als Objekt, ab 2021 mit XML zusätzlich abschnitte) statt nur der angefragten Seite(n)." } ], "responses": { "200": { "description": "OK" }, "400": { "description": "Seitenbereich ungültig (bis vor seite, oder mehr als 10 Seiten), bzw. Parameter passt nicht zur Quelle (ziffer/teil ohne XML, dokumentseite/bis mit XML)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } }, "404": { "description": "Keine Seite in einem Dokument dieses Jahrgangs gefunden, bzw. Dokument oder Ziffer nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } }, "502": { "description": "Bundesblatt-Abruf (Fedlex) fehlgeschlagen", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } }, "/api/v2/kantongesetz/{canton}/{law_id}": { "get": { "summary": "Kantonsgesetz-Übersicht", "description": "Metadaten zu einem kantonalen Erlass (`ZH`, `AG` oder `SZ`).\nFehlt der Text lokal, startet ein Hintergrund-Abruf (HTTP 202\n`status: fetching`, `retry_after_sec`; nachbereiten bis 200).\n", "tags": [ "Kantonsgesetze" ], "parameters": [ { "$ref": "#/components/parameters/canton" }, { "$ref": "#/components/parameters/law_id" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KantongesetzUebersicht" } } } }, "202": { "$ref": "#/components/responses/KantongesetzFetching" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } }, "502": { "$ref": "#/components/responses/KantongesetzFailed" } } } }, "/api/v2/kantongesetz/{canton}/{law_id}/kopf": { "get": { "summary": "Kantonsgesetz-Kopf", "description": "Titel-/Versionskopf für den Gesetzesreader.", "tags": [ "Kantonsgesetze" ], "parameters": [ { "$ref": "#/components/parameters/canton" }, { "$ref": "#/components/parameters/law_id" } ], "responses": { "200": { "description": "OK" }, "202": { "$ref": "#/components/responses/KantongesetzFetching" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } }, "502": { "$ref": "#/components/responses/KantongesetzFailed" } } } }, "/api/v2/kantongesetz/{canton}/{law_id}/gliederung": { "get": { "summary": "Kantonsgesetz-Gliederung", "description": "Inhaltsverzeichnis aus dem gecachten Reader-JSON.", "tags": [ "Kantonsgesetze" ], "parameters": [ { "$ref": "#/components/parameters/canton" }, { "$ref": "#/components/parameters/law_id" }, { "$ref": "#/components/parameters/sprache" } ], "responses": { "200": { "description": "OK" }, "202": { "$ref": "#/components/responses/KantongesetzFetching" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } }, "502": { "$ref": "#/components/responses/KantongesetzFailed" } } } }, "/api/v2/kantongesetz/{canton}/{law_id}/{article}": { "get": { "summary": "Kantonsartikel-Metadaten", "description": "Metadaten zu einem Paragraphen/Artikel eines kantonalen Erlasses.", "tags": [ "Kantonsgesetze" ], "parameters": [ { "$ref": "#/components/parameters/canton" }, { "$ref": "#/components/parameters/law_id" }, { "$ref": "#/components/parameters/article" } ], "responses": { "200": { "description": "OK" }, "202": { "$ref": "#/components/responses/KantongesetzFetching" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } }, "502": { "$ref": "#/components/responses/KantongesetzFailed" } } } }, "/api/v2/kantongesetz/{canton}/{law_id}/{article}/wortlaut": { "get": { "summary": "Kantonsartikel-Wortlaut", "description": "Wortlaut eines Paragraphen/Artikels (Absätze, Fussnoten).\nReader-Äquivalent: `/gesetz/ZH/GOG/3`, `/gesetz/AG/KV/1`, `/gesetz/SZ/KV/1`.\n", "tags": [ "Kantonsgesetze" ], "parameters": [ { "$ref": "#/components/parameters/canton" }, { "$ref": "#/components/parameters/law_id" }, { "$ref": "#/components/parameters/article" }, { "$ref": "#/components/parameters/sprache" } ], "responses": { "200": { "description": "OK" }, "202": { "$ref": "#/components/responses/KantongesetzFetching" }, "404": { "description": "Nicht gefunden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } }, "502": { "$ref": "#/components/responses/KantongesetzFailed" } } } }, "/api/v2/uebersetzen": { "post": { "summary": "Rechtstext übersetzen (de/fr/it)", "tags": [ "Übersetzung" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UebersetzenAnfrage" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UebersetzenAntwort" } } } }, "400": { "description": "Ungültige Anfrage", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } }, "413": { "description": "Text zu lang", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } }, "503": { "description": "Nicht konfiguriert", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fehler" } } } } } } } }, "components": { "responses": { "KantongesetzFetching": { "description": "On-Demand-Abruf läuft. Client soll nach `retry_after_sec` erneut anfragen.\nHTTP 202 ist kein Fehler.\n", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KantongesetzPending" } } } }, "KantongesetzFailed": { "description": "Letzter On-Demand-Versuch ist fehlgeschlagen (prozesslokaler Cache,\nDefault 300 s). `error` enthält die Meldung.\n", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KantongesetzFetchFailed" } } } } }, "schemas": { "Fehler": { "type": "object", "required": [ "fehler" ], "properties": { "fehler": { "type": "string" } }, "additionalProperties": false }, "ListenMeta": { "type": "object", "required": [ "gesamt", "limit", "versatz", "geliefert", "zaehlung_ausstehend" ], "properties": { "gesamt": { "type": [ "integer", "null" ], "description": "null solange COUNT asynchron läuft" }, "limit": { "type": "integer" }, "versatz": { "type": "integer" }, "geliefert": { "type": "integer" }, "zaehlung_ausstehend": { "type": "boolean" }, "gesamt_volltext": { "type": [ "integer", "null" ], "description": "Nur gesetzt, wenn q uebergeben wurde. null solange COUNT asynchron laeuft." }, "gesamt_thema": { "type": [ "integer", "null" ], "description": "Nur gesetzt, wenn q uebergeben wurde. null solange COUNT asynchron laeuft." }, "modus": { "type": "string", "enum": [ "volltext", "thema" ], "description": "Nur gesetzt, wenn q uebergeben wurde." }, "relevanz_schwelle_ueberschritten": { "type": "boolean", "description": "Nur gesetzt (true), wenn wegen sehr vieler Treffer auf Datumssortierung umgeschaltet wurde." }, "facetten": { "type": "object", "properties": { "jahr": { "type": "object", "additionalProperties": { "type": "integer" } } }, "additionalProperties": false } }, "additionalProperties": false }, "EntscheidListeEintrag": { "type": "object", "required": [ "referenz", "entscheid_id", "gericht" ], "properties": { "referenz": { "type": "string" }, "entscheid_id": { "type": "string" }, "entscheiddatum": { "type": [ "string", "null" ], "format": "date" }, "publikationsdatum": { "type": [ "string", "null" ], "format": "date" }, "sachgebiet": { "type": [ "string", "null" ] }, "themen": { "type": [ "string", "null" ] }, "erledigung": { "type": [ "string", "null" ] }, "sprache": { "type": [ "string", "null" ] }, "anzahl_richter": { "type": [ "integer", "null" ] }, "gericht": { "type": "string" }, "ist_bge": { "type": "boolean" }, "ist_bge_geplant": { "type": "boolean" }, "vorinstanz_gericht": { "type": [ "string", "null" ] }, "vorinstanz_kammer": { "type": [ "string", "null" ] }, "regeste": { "type": [ "string", "null" ] }, "titel": { "type": [ "string", "null" ] }, "api_url": { "type": "string" }, "viewer_url": { "type": "string" }, "treffer": { "$ref": "#/components/schemas/Treffer" } }, "additionalProperties": false }, "Treffer": { "type": "object", "description": "Nur enthalten, wenn q (Volltextsuche) uebergeben wurde.", "properties": { "ausschnitt": { "type": [ "string", "null" ], "description": "HTML-escaped Textausschnitt mit -Hervorhebung." }, "ausschnitt_abschnitt": { "type": [ "string", "null" ], "enum": [ "erwaegungen", "regeste", "meta_text", "sachverhalt", null ] }, "abschnitte": { "type": "object", "description": "Treffer je Abschnitt, z.B. {\"erwaegungen\": 12, \"sachverhalt\": 3}.", "additionalProperties": { "type": "integer" } } }, "additionalProperties": false }, "EntscheidListe": { "type": "object", "required": [ "daten", "meta" ], "properties": { "daten": { "type": "array", "items": { "$ref": "#/components/schemas/EntscheidListeEintrag" } }, "meta": { "$ref": "#/components/schemas/ListenMeta" } }, "additionalProperties": false }, "Vorinstanz": { "type": "object", "properties": { "gericht": { "type": "string" }, "kammer": { "type": "string" } }, "additionalProperties": false }, "Zitat": { "type": "object", "required": [ "referenz" ], "properties": { "referenz": { "type": "string" }, "url": { "type": [ "string", "null" ] }, "existiert": { "type": "boolean" }, "verlinkt": { "type": "boolean" }, "text": { "type": "string" } } }, "GesetzZitat": { "type": "object", "required": [ "text" ], "properties": { "text": { "type": "string" }, "url": { "type": [ "string", "null" ] } } }, "Referenzen": { "type": "object", "properties": { "bge_zitiert": { "type": "array", "items": { "$ref": "#/components/schemas/Zitat" } }, "bger_zitiert": { "type": "array", "items": { "$ref": "#/components/schemas/Zitat" } }, "bstger_zitiert": { "type": "array", "items": { "$ref": "#/components/schemas/Zitat" } }, "gesetze": { "type": "array", "items": { "$ref": "#/components/schemas/GesetzZitat" } } }, "additionalProperties": false }, "EntscheidMeta": { "type": "object", "properties": { "referenz": { "type": "string" }, "datum": { "type": [ "string", "null" ], "format": "date" }, "publikationsdatum": { "type": [ "string", "null" ], "format": "date" }, "sprache": { "type": [ "string", "null" ] }, "abteilung": { "type": [ "string", "null" ] }, "gegenstand": { "type": [ "string", "null" ] }, "erledigung": { "type": [ "string", "null" ] }, "anzahl_richter": { "type": [ "integer", "null" ] }, "ist_bge": { "type": "boolean" }, "ist_bstger": { "type": "boolean" }, "bge_publikation_vorgesehen": { "type": "boolean" }, "besetzung": { "type": [ "string", "null" ] }, "gerichtsschreiber": { "type": [ "string", "null" ] }, "parteien": { "type": [ "string", "null" ] }, "vorinstanz": { "$ref": "#/components/schemas/Vorinstanz" }, "quelle_url": { "type": [ "string", "null" ] }, "bge_meta": { "type": "object", "additionalProperties": true } } }, "Entscheid": { "type": "object", "required": [ "meta", "entscheid_id", "referenz", "sachverhalt", "erwaegungen", "dispositiv", "referenzen" ], "properties": { "meta": { "$ref": "#/components/schemas/EntscheidMeta" }, "entscheid_id": { "type": "string" }, "referenz": { "type": "string" }, "sprache": { "type": [ "string", "null" ] }, "erledigung": { "type": [ "string", "null" ] }, "anzahl_richter": { "type": [ "integer", "null" ] }, "regeste": { "type": "string" }, "titel": { "type": [ "string", "null" ] }, "quelle_url": { "type": [ "string", "null" ] }, "entscheiddatum": { "type": [ "string", "null" ], "format": "date" }, "gericht": { "type": [ "string", "null" ] }, "vorinstanz_gericht": { "type": [ "string", "null" ] }, "vorinstanz_kammer": { "type": [ "string", "null" ] }, "sachverhalt": { "type": "object" }, "erwaegungen": { "type": "object" }, "dispositiv": { "type": "object" }, "referenzen": { "$ref": "#/components/schemas/Referenzen" } }, "additionalProperties": false }, "Statistik": { "type": "object", "required": [ "entscheide_gesamt", "mit_volltext", "entscheiddatum_bereich", "nach_gericht", "gesetze_durchsuchbar" ], "properties": { "entscheide_gesamt": { "type": "integer" }, "mit_volltext": { "type": "integer" }, "entscheiddatum_bereich": { "type": "object", "properties": { "fruehestes": { "type": [ "string", "null" ], "format": "date" }, "spaetestes": { "type": [ "string", "null" ], "format": "date" } }, "additionalProperties": false }, "neuestes_publikationsdatum": { "type": [ "string", "null" ], "format": "date" }, "nach_gericht": { "type": "object", "properties": { "bger": { "type": "integer" }, "bge": { "type": "integer" }, "bge_egmr": { "type": "integer" }, "bstger": { "type": "integer" } } }, "gesetze_durchsuchbar": { "type": "integer" } }, "additionalProperties": false }, "LetzteAktualisierung": { "type": "object", "properties": { "letzte_aktualisierung": { "type": [ "string", "null" ] }, "letzte_aktualisierung_quelle": { "type": [ "string", "null" ] }, "heute_hinzugefuegt": { "type": "object", "additionalProperties": { "type": "integer" } } }, "additionalProperties": false }, "VorinstanzEintrag": { "type": "object", "required": [ "gericht", "anzahl", "vorinstanz" ], "properties": { "gericht": { "type": "string" }, "kammer": { "type": [ "string", "null" ] }, "anzahl": { "type": "integer" }, "vorinstanz": { "type": "string", "description": "Wert für Query-Parameter vorinstanz" } }, "additionalProperties": false }, "GesetzUebersicht": { "type": "object", "required": [ "sr", "abkuerzung" ], "properties": { "sr": { "type": "string" }, "abkuerzung": { "type": "object", "additionalProperties": { "type": [ "string", "null" ] } }, "titel": { "type": [ "string", "null" ] }, "fedlex_url": { "type": "object", "additionalProperties": { "type": [ "string", "null" ] } }, "zitierte_artikel_anzahl": { "type": "integer" }, "meistzitierte_artikel": { "type": "array", "items": { "type": "object", "properties": { "artikel": { "type": "string" }, "anzahl": { "type": "integer" }, "url": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false }, "UebersetzenAnfrage": { "type": "object", "required": [ "text", "quell_sprache", "ziel_sprache" ], "properties": { "text": { "type": "string", "maxLength": 12000 }, "quell_sprache": { "type": "string", "enum": [ "de", "fr", "it" ] }, "ziel_sprache": { "type": "string", "enum": [ "de", "fr", "it" ] } }, "additionalProperties": false }, "UebersetzenAntwort": { "type": "object", "required": [ "uebersetzter_text", "quelle" ], "properties": { "uebersetzter_text": { "type": "string" }, "quelle": { "type": "string", "enum": [ "noop", "cache", "db", "claude" ] } }, "additionalProperties": false }, "KantongesetzPending": { "type": "object", "required": [ "status" ], "properties": { "status": { "type": "string", "enum": [ "fetching" ] }, "canton": { "type": "string" }, "law_id": { "type": "string" }, "message": { "type": "string" }, "retry_after_sec": { "type": "integer", "minimum": 1, "example": 3 } }, "additionalProperties": false }, "KantongesetzFetchFailed": { "type": "object", "required": [ "status" ], "properties": { "status": { "type": "string", "enum": [ "failed" ] }, "canton": { "type": "string" }, "law_id": { "type": "string" }, "error": { "type": "string" } }, "additionalProperties": false }, "KantongesetzUebersicht": { "type": "object", "required": [ "ebene", "kanton", "gesetz_id" ], "properties": { "ebene": { "type": "string", "enum": [ "kantonal" ] }, "kanton": { "type": "string" }, "gesetz_id": { "type": "string" }, "systematische_nummer": { "type": [ "string", "null" ] }, "lexfind_id": { "type": [ "string", "null" ] }, "abkuerzung": { "type": "object" }, "titel": { "type": [ "string", "null" ] }, "quelle_url": { "type": "object" }, "artikel_anzahl": { "type": [ "integer", "null" ] }, "version_aktiv_seit": { "type": [ "string", "null" ] } }, "additionalProperties": false } }, "parameters": { "limit": { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 20 } }, "versatz": { "name": "versatz", "in": "query", "schema": { "type": "integer", "minimum": 0, "default": 0 } }, "sprache": { "name": "sprache", "in": "query", "schema": { "type": "string", "enum": [ "de", "fr", "it" ], "default": "de" }, "description": "Antwortsprache für Gesetzestexte (de/fr/it)." }, "sortierung": { "name": "sortierung", "in": "query", "schema": { "type": "string", "enum": [ "publikationsdatum", "entscheiddatum", "geschaeftsnummer", "erledigung", "sachgebiet" ], "default": "publikationsdatum" } }, "sortierung_entscheide": { "name": "sortierung", "in": "query", "description": "relevanz ist nur bei gesetztem q sinnvoll; ohne q Fallback auf publikationsdatum.", "schema": { "type": "string", "enum": [ "publikationsdatum", "entscheiddatum", "geschaeftsnummer", "erledigung", "sachgebiet", "relevanz" ], "default": "publikationsdatum" } }, "reihenfolge": { "name": "reihenfolge", "in": "query", "schema": { "type": "string", "enum": [ "absteigend", "aufsteigend" ], "default": "absteigend" } }, "gericht": { "name": "gericht", "in": "query", "schema": { "type": "string" }, "description": "Gerichtscode oder Kommaliste, z. B. bger,bge,bstger" }, "entscheid_id": { "name": "decision_id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Normalisierte ID, z. B. bger_8C_388_2024" }, "identifier": { "name": "identifier", "in": "path", "required": true, "schema": { "type": "string" }, "description": "SR-Nummer oder Abkürzung (z. B. 311.0 oder StGB)" }, "article": { "name": "article", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Artikelnummer in Kleinbuchstaben, z. B. 269quater" }, "canton": { "name": "canton", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Kantonskürzel. Derzeit ZH (Zürich/ZH-Lex), AG (Aargau/LexWork), SZ (Schwyz/SRSZ)." }, "law_id": { "name": "law_id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Gesetzeskürzel (GOG, KV, …) oder systematische Nummer (211.1, 110.000, 100.100)" }, "bbl_jahr": { "name": "jahr", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "Jahrgang des Zitats, z. B. 2013." }, "bbl_seite": { "name": "seite", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "Seitenzahl des Zitats, z. B. 2683 (sprachabhängig — FR/IT haben eigene Zählung). Ab 2021 die Dokumentnummer, z. B. 679 für «BBl 2023 679» (in allen Sprachen gleich)." } } } }