{"openapi": "3.0.3", "info": {"title": "Advokáti.Digital – judikatúra SR", "version": "1.0", "description": "Verejné JSON API nad súdnymi rozhodnutiami SR (InfoSud a otvorené dáta MS SR, OpenData NS SR, Ústavný súd SR). Bez autentizácie, limit 60 požiadaviek/min. Fulltext bez diakritiky, rozumie skloňovaniu (kmene + prefix; presne=1 vypne), syntax websearch (\"presná fráza\", -slovo, OR); ECLI/spisová značka v q = presný filter. Poradie: hustota pokrytia × váha súdu (ÚS/NS/NSS 1.0, krajské 0.5, okresné 0.3)."}, "servers": [{"url": "https://www.kauzis.sk/api/v1/judikatura"}], "paths": {"/search": {"get": {"summary": "Vyhľadávanie rozhodnutí", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}, "description": "fulltext (websearch syntax, skloňovanie automaticky; ECLI alebo spisová značka v q = presný filter)"}, {"name": "presne", "in": "query", "schema": {"type": "string"}, "description": "1 = presné tvary slov (bez kmeňovania)"}, {"name": "sud", "in": "query", "schema": {"type": "string"}, "description": "guid alebo slug súdu (pozri /courts)"}, {"name": "sudca", "in": "query", "schema": {"type": "string"}, "description": "id alebo registre_guid sudcu (v detaile rozhodnutia sudca_id; stránka /judikatura/sudca/<slug>)"}, {"name": "typ", "in": "query", "schema": {"type": "string"}, "description": "typ súdu: okresny, mestsky, krajsky, spravny, sts, najvyssi, nss, ustavny, eu, iny"}, {"name": "oblast", "in": "query", "schema": {"type": "string"}, "description": "oblasť práva: Občianske právo | Rodinné právo | Obchodné právo | Trestné právo | Správne právo | Ústavné právo"}, {"name": "forma", "in": "query", "schema": {"type": "string"}, "description": "forma rozhodnutia (Rozsudok, Uznesenie, Nález, …)"}, {"name": "od", "in": "query", "schema": {"type": "string"}, "description": "dátum vydania od (YYYY-MM-DD)"}, {"name": "do", "in": "query", "schema": {"type": "string"}, "description": "dátum vydania do (YYYY-MM-DD)"}, {"name": "rok", "in": "query", "schema": {"type": "integer"}, "description": "rok vydania"}, {"name": "ecli", "in": "query", "schema": {"type": "string"}, "description": "presné ECLI"}, {"name": "sz", "in": "query", "schema": {"type": "string"}, "description": "presná spisová značka"}, {"name": "predpis", "in": "query", "schema": {"type": "string"}, "description": "citovaný predpis: 160/2015, skratka (CSP, OZ, TZ, TP, ObZ, ZP, CMP, SSP, EP, ZKR…) alebo IRI /SK/ZZ/2015/160"}, {"name": "paragraf", "in": "query", "schema": {"type": "string"}, "description": "číslo § / čl. v predpise (420, 127) – všetky odseky"}, {"name": "s_textom", "in": "query", "schema": {"type": "string"}, "description": "1 = len rozhodnutia s plným textom"}, {"name": "semanticky", "in": "query", "schema": {"type": "string"}, "description": "0 = vypnúť hybridné poradie (fulltext + vektorová podobnosť významu, bge-m3); odpoveď má pole mode = hybrid | fts"}, {"name": "stav", "in": "query", "schema": {"type": "string"}, "description": "stav rozhodnutia podľa výrokov vyšších súdov: zrusene | zmenene | potvrdene | zamietnute (opravný prostriedok zamietnutý/odmietnutý) | porusene (nález ÚS SR) | platne (nie zrušené ani zmenené) | bez (bez zisteného stavu)"}, {"name": "sort", "in": "query", "schema": {"type": "string"}, "description": "relevance | date_desc | date_asc"}, {"name": "page", "in": "query", "schema": {"type": "integer"}, "description": "strana"}, {"name": "page_size", "in": "query", "schema": {"type": "integer"}, "description": "max 50"}, {"name": "facets", "in": "query", "schema": {"type": "string"}, "description": "1 = pridať fazety (typ, forma, rok)"}], "operationId": "searchDecisions", "responses": {"200": {"description": "OK (JSON)"}}}}, "/{slug}": {"get": {"summary": "Detail rozhodnutia (ECLI alebo guid) vrátane plného textu, citačných väzieb (cituje, citovane_v) a citacie_n", "operationId": "getDecision", "parameters": [{"name": "slug", "in": "path", "required": true, "schema": {"type": "string"}, "description": "ECLI alebo guid rozhodnutia; pri predpisoch slug 160-2015; pri vzoroch slug vzoru"}], "responses": {"200": {"description": "OK (JSON)"}}}}, "/{slug}/text": {"get": {"summary": "Plný text rozhodnutia ako text/plain", "operationId": "getDecisionText", "parameters": [{"name": "slug", "in": "path", "required": true, "schema": {"type": "string"}, "description": "ECLI alebo guid rozhodnutia; pri predpisoch slug 160-2015; pri vzoroch slug vzoru"}], "responses": {"200": {"description": "OK (JSON)"}}}}, "/courts": {"get": {"summary": "Zoznam súdov a typov", "operationId": "listCourts", "parameters": [], "responses": {"200": {"description": "OK (JSON)"}}}}, "/stats": {"get": {"summary": "Počty rozhodnutí", "operationId": "getStats", "parameters": [], "responses": {"200": {"description": "OK (JSON)"}}}}, "/predpisy": {"get": {"summary": "Fulltext v textoch právnych predpisov (Slov-Lex, po paragrafoch)", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}, "description": "hľadaný text (skloňovanie automaticky, websearch syntax)"}, {"name": "predpis", "in": "query", "schema": {"type": "string"}, "description": "obmedziť na predpis: 160/2015, skratka alebo IRI"}, {"name": "page", "in": "query", "schema": {"type": "integer"}}, {"name": "page_size", "in": "query", "schema": {"type": "integer"}, "description": "max 50"}], "operationId": "searchStatuteText", "responses": {"200": {"description": "OK (JSON)"}}}}, "/zakony": {"get": {"summary": "Prehľad celej Zbierky zákonov SR (všetky predpisy z registra Slov-Lex od 1945) s filtrami a hľadaním; vracia count, results[] (iri, cislo, skratka, nazov, typ, typ_nazov, rocnik, vyhlaseny, schvaleny, ucinny_od, ucinny_do, stav = ucinny|zruseny|buduci, oblasti[], autor, ma_znenie, ustanoveni_n, url, api_url, slovlex_url), filtre (hodnoty s počtami), spolu, aktualne_k", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}, "description": "číslo predpisu (586/2003), skratka (CSP, OZ, TZ…) alebo názov/téma (skloňovanie automaticky; váhy číslo+názov > právne oblasti > nadpisy §)"}, {"name": "typ", "in": "query", "schema": {"type": "string"}, "description": "typ predpisu (Zakon, UstavnyZakon, NariadenieVlady, Vyhlaska, Opatrenie, Oznamenie…; hodnoty vo filtre.typ)"}, {"name": "rok", "in": "query", "schema": {"type": "integer"}, "description": "ročník Zbierky"}, {"name": "od", "in": "query", "schema": {"type": "integer"}, "description": "ročník od"}, {"name": "do", "in": "query", "schema": {"type": "integer"}, "description": "ročník do"}, {"name": "platnost", "in": "query", "schema": {"type": "string"}, "description": "vsetky | ucinne | zrusene | buduce (podľa dátumov účinnosti zo Slov-Lex)"}, {"name": "oblast", "in": "query", "schema": {"type": "string"}, "description": "právna oblasť podľa Slov-Lex, napr. Trestné právo, Daňové právo (hodnoty vo filtre.oblast)"}, {"name": "znenie", "in": "query", "schema": {"type": "string"}, "description": "1 = len predpisy so znením po paragrafoch"}, {"name": "sort", "in": "query", "schema": {"type": "string"}, "description": "relevance (pri q) | novsie | starsie | nazov"}, {"name": "page", "in": "query", "schema": {"type": "integer"}, "description": "strana"}, {"name": "page_size", "in": "query", "schema": {"type": "integer"}, "description": "max 100"}, {"name": "filtre", "in": "query", "schema": {"type": "string"}, "description": "0 = bez hodnôt filtrov"}], "operationId": "listStatutes", "responses": {"200": {"description": "OK (JSON)"}}}}, "/zz": {"get": {"summary": "Ročníky Zbierky zákonov s počtami; /zz/{rok} predpisy ročníka (typ, q)", "operationId": "listCollectionYears", "parameters": [], "responses": {"200": {"description": "OK (JSON)"}}}}, "/predpis/{slug}": {"get": {"summary": "Právny predpis: metadáta, obsah (všetky § s nadpismi a zaradením), časové verzie; slug = 160-2015", "operationId": "getStatute", "parameters": [{"name": "slug", "in": "path", "required": true, "schema": {"type": "string"}, "description": "ECLI alebo guid rozhodnutia; pri predpisoch slug 160-2015; pri vzoroch slug vzoru"}], "responses": {"200": {"description": "OK (JSON)"}}}}, "/predpis/{slug}/{key}": {"get": {"parameters": [{"name": "slug", "in": "path", "required": true, "schema": {"type": "string"}, "description": "ECLI alebo guid rozhodnutia; pri predpisoch slug 160-2015; pri vzoroch slug vzoru"}, {"name": "key", "in": "path", "required": true, "schema": {"type": "string"}, "description": "kľúč ustanovenia, napr. paragraf-420 alebo clanok-1"}, {"name": "znenie", "in": "query", "schema": {"type": "string"}, "description": "YYYY-MM-DD – pridá znenie účinné k dátumu (časové verzie najcitovanejších predpisov); odpoveď má aj zoznam verzií"}, {"name": "html", "in": "query", "schema": {"type": "string"}, "description": "1 = aj HTML"}], "summary": "Znenie ustanovenia (text, html=1 aj HTML), predchádzajúce/nasledujúce, počet a výber rozhodnutí k nemu; key = paragraf-420 | ustavnyclanok-127 | clanok-5", "operationId": "getStatuteSection", "responses": {"200": {"description": "OK (JSON)"}}}}, "/vzory": {"get": {"summary": "Zoznam vzorov podaní na súd (slug, názov, oblasť, lehota)", "operationId": "listFilingTemplates", "parameters": [], "responses": {"200": {"description": "OK (JSON)"}}}}, "/usmernenia": {"get": {"summary": "Metodické pokyny a usmernenia orgánov verejnej moci (FS SR, MF SR, ÚGKK – Katastrálny bulletin): fulltext a filtre; nie sú všeobecne záväzné, neplatné necitovať", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}, "description": "fulltext (skloňovanie automaticky, websearch syntax)"}, {"name": "organ", "in": "query", "schema": {"type": "string"}, "description": "fssr | mfsr | ugkk | gpsr | uvo"}, {"name": "druh", "in": "query", "schema": {"type": "string"}, "description": "mp | mu | us | st | inf | kb | pvp"}, {"name": "oblast", "in": "query", "schema": {"type": "string"}, "description": "oblasť, napr. Priame dane a účtovníctvo, Nepriame dane, Daňový proces, Kataster nehnuteľností"}, {"name": "predpis", "in": "query", "schema": {"type": "string"}, "description": "595/2003, skratka alebo IRI"}, {"name": "paragraf", "in": "query", "schema": {"type": "string"}, "description": "číslo §"}, {"name": "platne", "in": "query", "schema": {"type": "string"}, "description": "1 = len platné (predvolené), 0 = aj neplatné/nahradené"}, {"name": "od", "in": "query", "schema": {"type": "string"}, "description": "YYYY-MM-DD"}, {"name": "do", "in": "query", "schema": {"type": "string"}, "description": "YYYY-MM-DD"}, {"name": "sort", "in": "query", "schema": {"type": "string"}, "description": "relevance | date_desc | date_asc"}, {"name": "page", "in": "query", "schema": {"type": "integer"}, "description": ""}, {"name": "page_size", "in": "query", "schema": {"type": "integer"}, "description": "max 50"}], "operationId": "searchGuidance", "responses": {"200": {"description": "OK (JSON)"}}}}, "/usmernenia/{slug}": {"get": {"summary": "Usmernenie (metadáta, citované ustanovenia, text po častiach) podľa slugu, guid alebo čísla; ?cast=<názov dielu | Otázka | Odpoveď | poradové číslo> vráti len jednu časť", "operationId": "getGuidance", "parameters": [{"name": "slug", "in": "path", "required": true, "schema": {"type": "string"}, "description": "ECLI alebo guid rozhodnutia; pri predpisoch slug 160-2015; pri vzoroch slug vzoru"}], "responses": {"200": {"description": "OK (JSON)"}}}}, "/dovodove": {"get": {"summary": "Dôvodové správy k zákonom a novelám (úmysel predkladateľa – Slov-Lex eLegislatíva, NR SR): fulltext po oddieloch osobitnej časti („K § 420“, „K bodu 3“) a všeobecnej časti; q alebo predpis povinné. Vracia count, results[] (predpis, novela_iri, novela_cislo, lp, nazov, datum, k, key, keys, druh, uryvok, text, url, api_url, zdroj_url). Nie je záväzný výklad – citovať ako pomôcku (zákon č., LP/tlač, URL)", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}, "description": "fulltext v oddieloch (skloňovanie automaticky, websearch syntax)"}, {"name": "predpis", "in": "query", "schema": {"type": "string"}, "description": "predpis: 160/2015, skratka (CSP, OZ, TZ…) alebo IRI /SK/ZZ/2015/160"}, {"name": "paragraf", "in": "query", "schema": {"type": "string"}, "description": "číslo § / čl. (420, 22a, čl. 5) – len oddiely k ustanoveniu"}, {"name": "key", "in": "query", "schema": {"type": "string"}, "description": "kľúč ustanovenia namiesto paragraf: paragraf-420 | clanok-5"}, {"name": "page", "in": "query", "schema": {"type": "integer"}, "description": "strana"}, {"name": "page_size", "in": "query", "schema": {"type": "integer"}, "description": "max 50"}, {"name": "presne", "in": "query", "schema": {"type": "string"}, "description": "1 = presné tvary slov (bez kmeňovania)"}], "operationId": "searchExplanatoryMemoranda", "responses": {"200": {"description": "OK (JSON)"}}}}, "/dovodove/{slug}": {"get": {"summary": "Dôvodové správy predpisu (k samotnému zákonu aj k jeho novelám; slug = 160-2015): spravy[] (id, nazov, novela_iri, novela_cislo, lp, datum, zdroj_url, vseobecna, osobitna[{k, key, keys, text}], osobitna_n, url, api_url); 404 ak predpis nie je v DB alebo nemá dôvodovú správu", "parameters": [{"name": "slug", "in": "path", "required": true, "schema": {"type": "string"}, "description": "ECLI alebo guid rozhodnutia; pri predpisoch slug 160-2015; pri vzoroch slug vzoru"}, {"name": "key", "in": "query", "schema": {"type": "string"}, "description": "len oddiely k ustanoveniu (bez všeobecnej časti): paragraf-420"}, {"name": "paragraf", "in": "query", "schema": {"type": "string"}, "description": "číslo § / čl. namiesto key: 420"}, {"name": "cast", "in": "query", "schema": {"type": "string"}, "description": "all | vseobecna | osobitna"}, {"name": "max_chars", "in": "query", "schema": {"type": "integer"}, "description": "orezanie textu jednej správy (predvolené 60000; najprv sa kráti všeobecná časť, potom oddiely od konca; poznamka hovorí, čo chýba)"}, {"name": "id", "in": "query", "schema": {"type": "integer"}, "description": "len jedna správa (id z výsledkov /dovodove)"}], "operationId": "getExplanatoryMemoranda", "responses": {"200": {"description": "OK (JSON)"}}}}, "/vzory/{slug}": {"get": {"summary": "Vzor podania: štruktúra, zákonné náležitosti so znením ustanovení, lehota, poplatok, zastúpenie, judikatúra, tipy", "operationId": "getFilingTemplate", "parameters": [{"name": "slug", "in": "path", "required": true, "schema": {"type": "string"}, "description": "ECLI alebo guid rozhodnutia; pri predpisoch slug 160-2015; pri vzoroch slug vzoru"}], "responses": {"200": {"description": "OK (JSON)"}}}}}}