API REST — OpenCaseLaw

Automatisar la retschertga en il terminal

Installai il client lev cun pipx u uv. Salvai resultats limitads, consultai consideraziuns exactas, schliai glistas da citaziuns e conservai las funtaunas. Il client è publitgà sin PyPI sco opencaselaw-cli.

pipx install opencaselaw-cli   # or: uv tool install opencaselaw-cli
ocl --help
ocl bundle create 'missbräuchliche Kündigung Rachekündigung' \
  --max-results 5 --law OR:336 --out research-bundle

Guida CLI: pipelines, pachets da funtaunas e resoluziun da citaziuns →

Cumenzament svelt — tschertgar en il corpus

curl -s "https://mcp.opencaselaw.ch/api/decisions?q=Mietrecht+K%C3%BCndigung&limit=5"

Returna:

{
  "total": 1006,
  "total_is_lower_bound": false,
  "returned": 5,
  "results": [
    { "decision_id": "bge_BGE_140_III_86", "court": "bge",
      "decision_date": "2014-04-15", "language": "de",
      "title": "Mietrecht; …", "regeste": "…",
      "citation_string_de": "BGE 140 III 86", "canonical_url": "https://mcp.opencaselaw.ch/entscheid/…" },
    …
  ],
  "limit": 5, "offset": 0, "has_more": true, "next_offset": 5
}

Controllai total_is_lower_bound avant da considerar total sco exact. Suandai next_offset uschè ditg che has_more è vair. Ina tschertga tenor relevanza po exaurir ses dumber limità da candidats avant da returnar tut ils resultats: has_more: false na cumprova betg ina retschertga cumpletta. Filtres restrenschan la selecziun; per analisar l’entir corpus duvrai il download Parquet.

Cumenzament svelt — consultar in artitgel

curl -s "https://mcp.opencaselaw.ch/api/laws/OR?article=41"

{
  "sr_number": "220",
  "abbreviation": "OR",
  "title": "Bundesgesetz vom 30. März 1911 …",
  "consolidation_date": "2026-01-01",
  "language": "de",
  "articles": [
    { "article_num": "41", "heading": null,
      "text": "1 Wer einem andern widerrechtlich Schaden zufügt, …" }
  ]
}

Ils nums vegnan renconuschids en DE/FR/IT, independentamain da maiusclas, puncts e spazis (Cst, OPP2, o.p.p. 2); contracts internaziunals cun lur num usità (IPBPR, KRK, CISG) e denominaziuns anteriuras (OG → BGG, cun ina remartga) vegnan resolvids tras la tabella CC0 law_aliases.json; acts chantunals portan lur chantun en omadus urdens: /api/laws/StG/ZH.

Parameters frequents

Parameter	Duvrà da	Notas
q	tut ils puncts da tschertga	Tschertga en text liber; la tschertga da decisiuns accepta `query` e `q`. Operaturs booleans (AND, OR, NOT), frasas exactas, numers da dossier e referenzas BGE. Ils resultats tenor relevanza èn limitads; controllai la paginaziun e las indicaziuns da limita inferiura.
query	tut ils puncts da tschertga	Tschertga en text liber. Tar `/decisions` ha in `query` betg vid precedenza davant `q`. Consultai ils parameters da mintga endpunct.
limit	dapertut	Valurs predefinidas e maximas dependan da l’endpunct. La tschertga da decisiuns po reducir ils detagls u la grondezza da pagina. Duvrai il dumber returnà ed ils champs da cuntinuaziun per la paginaziun, betg la limita dumandada.
offset	/decisions · /citations/{decision_id}	Offset da paginaziun, nua ch’el è sustegnì. Suandai `next_offset`; las glistas da citaziuns inditgeschan la cuntinuaziun per mintga direcziun.
language	/decisions	`de` / `fr` / `it`. Filtrescha tenor la lingua da la decisiun.
canton	/decisions · /laws/search	Code chantunal da duas letras (ZH, BE, …) u `CH` per il federal.
court	/decisions	Clav da la dretgira (bger, bvger, ge_gerichte, …). Vesair /courts.
jurisdiction	/laws/search	`all`, `federal` u `cantonal`.
article	/laws/{abbreviation}	Numer d'artitgel (p.ex. `41`, `266l`).

Referenza dals puncts final

Decisiuns

GET/api/decisionsTschertgar decisiuns. Returna resultats paginads cun citaziuns + URLs canonics.
GET/api/decisions/{decision_id}Retschaiver ina singula decisiun cun text cumplet.
GET/api/decisions/{decision_id}/export.docxExportar sco document Word (citaziun, regest, consideraziuns structuradas).
GET/api/decisions/{decision_id}/export.bibEndataziun BibTeX per bibliografias LaTeX.
GET/api/decisions/{decision_id}/export.risEndataziun RIS per Zotero / EndNote / Mendeley.
GET/api/decisions/{decision_id}/export.pdfRenderisaziun PDF da la decisiun.
GET/api/case-brief/{case}Brev structurà: facts · motivaziun · leschas · autoritad · associads.
GET/api/structure/{decision_id}Fatgs + consideraziuns (paragrafs) + dispositiv + regest.
GET/api/erwaegung/{decision_id}/{e_number}Unitad da citaziun svizra litterala (p.ex. 2.3).
GET/api/regeste/{decision_id}Text uffizial dal regest dal TF / TAF.

Graf da citaziuns

GET/api/citations/{decision_id}Omaduas direcziuns: tge ch'i citescha + tge ch'al citescha.
GET/api/appeal-chain/{decision_id}Istorgia procedurala tras las instanzas.
GET/api/leading-casesDecisiuns ordinadas tenor autoritad per ina lescha / in tema.
GET/api/citeConstruir ina citaziun formatada dal server.

Leschas & doctrina

GET/api/laws/searchFTS5 federada sur artitgels federals + chantunals. Returna extracts.
GET/api/laws/{abbreviation}Singul artitgel tenor abreviaziun (OR, ZGB, StGB, …).
GET/api/legislation/searchTschertga en il catalog LexFind (33 000+ acts federals + chantunals).
GET/api/legislation/{lexfind_id}Singula endataziun legislativa.
GET/api/legislation/changesMidadas dal dretg federal recentas ed avegnentas.
GET/api/doctrineText da lescha + BGE ordinads + cronologia da doctrina + extract da commentari.
GET/api/materialienMessadis dal Cussegl federal — intenziun legislativa.
GET/api/materialien/{law_code}Material per ina lescha specifica.
GET/api/amendment-refReslucziun dals models "Art. X (versiun revedida Y)".

Commentari & instrucziun

GET/api/commentaries/searchTschertgar extracts OnlineKommentar + OpenLegalCommentary.
GET/api/commentaries/{abbreviation}Index dal commentari per ina lescha (OR, ZGB, …).
GET/api/exam-questionVer model da fatgs BGE sco cas pratic cun analisa zuppada.
GET/api/mock-decisionDecisiun fittiva (mo per perscrutaziun) da fatgs + giurisprudenza + leschas.

Verificaziun & introspecziun

POST/api/attestControllar ina sbozza da resposta — verifitgescha mintga BGE / art. / citaziun cunter il corpus avant ch'ella bandunescha il server. Certifitgescha las citaziuns, ils passadis citads e las referenzas da lescha da la sbozza sezza; na certifitgescha betg che nagina autoritad relevanta manca.
GET/api/courtsFar ina glista da tut las 121 dretgiras (federalas, da regulaziun, internaziunalas, chantunalas).
GET/api/statisticsStatisticas aggregadas — corpus, graf da citaziuns, leschas, linguas.
GET/api/scraper-healthStatus da l'ultima execuziun per funtauna (maina /coverage).
GET/api/atom/{court}.xmlFeed Atom — las 50 decisiuns las pli novas per dretgira.

La specificaziun da l’applicaziun descriva las rutas disponiblas; la cuvertura dals schemas da resposta variescha. Questa versiun dal code agiunta ina specificaziun publica tipisada a /api/research/openapi.json. Ella è disponibla pir suenter la publicaziun; vesair las notas dal contract.

Limitas da frequenza