Prawnet — Polish case law & legislation

Remote MCP server for Polish law: search ~656k court rulings (common courts, Supreme Court, Constitutional Tribunal, KIO) and ~165k acts, read provision text (also as of a past date for main codes), find leading rulings for an article by citation authority, check whether a cited case number exists (hallucination check), and get outcome statistics. Streamable HTTP at https://api.prawnet.pl/mcp; works without a key (rate-limited), API keys for higher limits.

Hosted MCP Server

npx add-mcp 'https://api.prawnet.pl/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

API grafu cytowań BETA

Programistyczny dostęp do danych orzeczniczych: graf przepis ↔ orzeczenie bezpłatnie z kluczem, a na licencji dziewięć tras, których z grafu wyprowadzić się nie da. Na żywo, w JSON. Bez treści orzeczeń w żadnym planie: wyłącznie krawędzie, metadane, etykiety i liczby.

659 155 orzeczeń. Zakres: SN do 06.2016 z archiwum SAOS, później z repozytorium Sądu Najwyższego (repozytorium2.sn.pl), stan do 11.2026; TK: do 2015 r. z SAOS, nowsze orzeczenia z serwisu trybunal.gov.pl; KIO od 2007 r. (od 2018 r. z bazy UZP, na bieżąco); sądy powszechne w zakresie publikacji SAOS (ostatnie lata rzadziej — sądy publikują z opóźnieniem i wybiórczo); NSA/WSA: wybrane orzeczenia — cytowane w korpusie oraz uchwały NSA, stan do 03.2025 (CBOSA, za zbiorem JuDDGES/pl-nsa, CC BY 4.0) — nie wszystkie orzeczenia NSA/WSA.

Szybki start

Jedno zapytanie i działa

Wygeneruj klucz w panelu (Klucze API), dodaj nagłówek Authorization i wywołaj dowolny endpoint. Klucz pokazujemy tylko raz — przechowujemy wyłącznie jego skrót.

curl -H "Authorization: Bearer pk_live_TWOJ_KLUCZ" \
  "https://api.prawnet.pl/v1/przepisy/1964/93/415/orzeczenia?limit=10"
curl -H "Authorization: Bearer pk_live_TWOJ_KLUCZ" \
  "https://api.prawnet.pl/v1/weryfikuj/sygnatura?q=III+CZP+100/14"
# klucz w planie free → 403 {"error":"plan-required"}

Prefiks adresów: https://api.prawnet.pl/v1 (równoważnie: https://prawnet.pl/api/v1) — sam prefiks nie jest endpointem, wywołuje się dopiero konkretną ścieżkę poniżej. Odpowiedzi są w JSON (UTF-8) i — gdy wywołanie niesie klucz — zawsze prywatne (Cache-Control: private), bo każde takie zapytanie jest zliczane na Twoim kluczu. Wyjątek dotyczy wyłącznie anonimowego wywołania /v1/cytuj, które nie jest z niczym związane i może być cache’owane publicznie.

Specyfikacja OpenAPI 3.1 (ścieżki, parametry, kody błędów, nagłówki limitów) do wygenerowania klienta albo importu do Postmana: https://api.prawnet.pl/v1/openapi.json. Specyfikacja jest skrótem — pełne znaczenie pól opisuje ta strona.

Co jest stabilne, co beta. Stabilne (ścieżka, parametry i pola odpowiedzi nie zmienią się bez zmiany wersji; pola mogą dojść): weryfikacja sygnatury pojedyncza i hurtowa, rezolwer /v1/cytuj, orzeczenia do przepisu i pozostałe trasy grafu, orzeczenia wiodące, statystyki rozstrzygnięć i kwot (…/stats, /v1/statystyki/rozstrzygniecia). Beta (kształt odpowiedzi może się jeszcze zmienić, a dane mają zastrzeżenia opisane w karcie): brzmienie przepisu na dzień (10 aktów), mediany czasu (/v1/statystyki/czas), autorytet, sieć cytowań i rozstrzygnięcie per orzeczenie — oraz sama specyfikacja OpenAPI. Każda karta niżej ma plakietkę „stabilna” albo „beta”, a każda operacja w OpenAPI pole x-stability o tej samej wartości.

Warstwa darmowa

Sześć uchwytów do grafu

Wszystkie metodą GET, wszystkie z kluczem w dowolnym planie (poza /v1/cytuj, gdzie klucz jest opcjonalny). Adresy przepisów używają współrzędnych Dz.U.: rok, pozycja i artykuł (np. 1964 / 93 / 415 = art. 415 k.c.; artykuły z indeksem górnym zapisujemy z łącznikiem: 449-1).

GET /v1/przepisy/{rok}/{poz}/{art}/orzeczenia stabilna

Orzeczenia powołujące jeden przepis Dz.U. (najnowsze najpierw) + liczniki per sąd. Metadane, numeryczne id (do tras /v1/orzeczenia/{id}/…) i stały link — bez treści orzeczeń.

Parametry: sad (SUPREME | CONSTITUTIONAL_TRIBUNAL | NATIONAL_APPEAL_CHAMBER | COMMON | ADMINISTRATIVE), limit ≤ 200, offset ≤ 5000

Przykład: /v1/przepisy/1964/93/415/orzeczenia?limit=10

GET /v1/przepisy/{rok}/{poz}/{art}/stats stabilna

Statystyka jednego przepisu: total i wgSadu (cytowania per sąd) oraz — gdy dostępna — wynik: n (orzeczenia z etykietą o wysokiej pewności); instancje.{pierwsza|apelacja|kasacja|inna} = { n, wyniki, procent } — rozkład wyników OSOBNO dla każdej instancji (w apelacji „oddalenie” = apelację oddalono, wyrok I instancji utrzymany), procent tylko od n ≥ 20 i sumuje się do 100; kwoty_wg_rodzaju.{zadoscuczynienie|odszkodowanie} = { n, q1, mediana, q3, instancja: "pierwsza", okres: {od, do} } — wyłącznie wyroki I instancji, 100 zł–2 mln zł, każdy rodzaj osobno, tylko od 20 kwot (wyroki z oboma rodzajami i zwroty z umów kredytowych pominięte); kwota = blok rodzaju z największą liczbą kwot (+ rodzaj, udzial) albo null; kwoty_razem_n; uwaga. wynik_powod: null | brak-etykiet | niedostepne | blad; wynik_pewnosc: "wysoka"; wynik_uwaga — zastrzeżenie do etykiet. Rozkład „według przepisu” to próba wyselekcjonowana (np. przepis o odsetkach sąd powołuje głównie przy zasądzeniu) — nie szansa wygrania sprawy.

Parametry: —

Przykład: /v1/przepisy/1964/93/415/stats

GET /v1/przepisy/{rok}/{poz}/artykuly stabilna

Wszystkie artykuły jednego aktu z liczbą orzeczeń (malejąco) — mapa cytowań całej ustawy.

Parametry: —

Przykład: /v1/przepisy/1964/93/artykuly

GET /v1/przepisy/top stabilna

Najczęściej cytowane pary (akt, artykuł) w całym grafie.

Parametry: min (próg cytowań, domyślnie 5), limit ≤ 200, offset ≤ 5000

Przykład: /v1/przepisy/top?min=100&limit=20

GET /v1/orzeczenia/{id}/przepisy stabilna

Przepisy Dz.U. powołane w jednym orzeczeniu (art = null to powołanie całego aktu).

Parametry: —

Przykład: /v1/orzeczenia/123456/przepisy

GET /v1/cytuj stabilna

Rezolwer cytatu: sygnatura → kanoniczny adres orzeczenia, kandydaci, rozbiór sygnatury i gotowy zapis cytatu. Jedyna trasa /v1, na której klucz jest opcjonalny.

Parametry: sygn (albo q) — JEDNA sygnatura w dowolnej pisowni, do 1000 znaków (dłuższy ciąg przycinamy na granicy słowa, nigdy w środku sygnatury — wtedy wejscie_przyciete: true); sad i data (RRRR-MM-DD) — jak w /v1/weryfikuj/sygnatura: tylko te dwa parametry ustawiają w_podanym_sadzie / data_zgodna (true albo false) i mogą dać inny_sad; sąd i data z samego tekstu sygn nie są porównywane — pola zostają null, a uwaga_kontekstu cytuje je obok tego, co mamy. Ciąg, którego nie da się rozebrać → 422 status nie_rozpoznano; kilka różnych sygnatur → 400 multiple-signatures; zła data → 400 bad-date. Statusy i pola (istnieje, uwaga, data_zgodna, n_cytowan) — jak w weryfikacji sygnatury; kandydaci[].court_name to nazwa sądu („Sąd Najwyższy"), nigdy wydział.

Przykład: /v1/cytuj?sygn=III%20CZP%20100/14

{
  "status": "znaleziono" | "niejednoznaczne" | "inny_sad" | "cytowana"
          | "brak" | "poza_zakresem",       // 422 przy nie_rozpoznano
  "zapytanie": <str>, "sprawdzono": <str>, "sad_zapytany": <str|null>,
  "url": <str>,               // JEDEN kanoniczny adres (orzeczenie albo strona sygnatury)
  "istnieje": <bool|null>, "w_zakresie": <bool>,
  "w_podanym_sadzie": <bool|null>, "data_zgodna": <bool|null>,
  "data_podana": <str|null>, "inny_typ_sadu": <bool>,
  "uwaga_kontekstu": <str>,   // tylko gdy tekst sygn podaje sąd/datę: cytat z tekstu obok naszych danych
  "wejscie_przyciete": true,  // tylko gdy sygn przycięto do 1000 znaków
  "uwaga": "numer_nietypowy" | "malo_cytowan" | "numer_w_innym_sadzie"
         | "numer_powszechny" | null,
  "mozliwa_literowka": [<str>] | null,   // TK/KIO: sprawa z tego dnia o jeden znak od pytanej
  "n_cytowan": <int>, "n_sadow_cytujacych": <int>,
  "werdykt": <str>, "zakres": <str>,
  "parse": { "kanon": <str>, "kanon4": <str>, "slug": <str>,
             "wydzial": <str|null>, "repertorium": <str>,
             "numer": <int>, "rok": <int>, "szczebel": <str>,
             "typ": <str|null>, "wyjasnienie": <str> },
  "cytat": { "prawniczy": <str>, "iso690": <str> } | null,  // tylko przy jednym trafieniu
  "kandydaci": [ { "id": <int>, "slug": <str>, "case_number": <str>, "court_type": <str>,
                   "court_name": <str|null>, "judgment_type": <str|null>,
                   "judgment_date": <date|null>, "zrodlo": "saos" | "uzp" | "tk",
                   "zrodlo_url": <str>, "url": <str>, "sad": <str> } ],
  "sady": [ { "sad": <str>, "court_type": <str>, "pasuje": <bool|null>,
              "dokumenty": [ { "id": <int>, "url": <str>, "case_number": <str>,
                               "judgment_type": <str|null>, "judgment_date": <date|null> } ] } ],
  "gdzie_szukac": [ { "nazwa": <str>, "url": <str> } ],   // oficjalne rejestry
  "wersja_danych": { "korpus": <str>, "parser_sygnatur": <int>,
                     "zrodlo": <str>, "wygenerowano": <iso8601> }
}

Warstwa licencjonowana

Dziewięć rzeczy, których graf nie powie

Te same reguły co wyżej — JSON, ten sam klucz i ten sam licznik — plus jeden warunek: klucz musi być w planie pro. Klucz w planie free dostaje tu 403 plan-required, świadomie innym kodem niż 403 przy złym kluczu. Osiem tras wywołuje się metodą GET; weryfikacja hurtowa to POST i jako jedyna kosztuje tyle jednostek, ile ma pozycji — bez rabatu za hurt. Ścieżki są ustalone; które trasy są stabilne, a które jeszcze beta, mówi plakietka na każdej karcie i akapit „Co jest stabilne, co beta” wyżej.

Plan licencjonowany nie jest samoobsługowy

Klucze generujesz sam w panelu (Klucze API) — zawsze w planie free. Przejścia na plan pro nie da się kupić klikiem: umawiamy je indywidualnie, bo warstwa licencjonowana idzie z warunkami umowy (licencja obejmuje naszą bazę danych i jej opracowanie — graf, etykiety, autorytet, wersje przepisów — w zakresie, w jakim przysługują nam do nich prawa; same orzeczenia i akty prawne nie są przedmiotem prawa autorskiego), a nie z samym limitem zapytań. Napisz na info@prawnet.pl, którego endpointu potrzebujesz i do czego, a podniesiemy plan na Twoim kluczu. Do tego czasu ten sam klucz działa bez zmian na całej warstwie darmowej.

Żadna z tych tras nie zwraca treści orzeczeń — ani darmowa, ani licencjonowana. Wydajemy metadane, krawędzie grafu, etykiety, liczby i (wyłącznie dla przepisów) brzmienie artykułu. Pełne teksty orzeczeń zostają w rejestrach źródłowych (SAOS, UZP, Trybunał Konstytucyjny, CBOSA — wybór NSA/WSA, CC BY 4.0 — i repozytorium SN, repozytorium2.sn.pl) i na stronach orzeczeń, dokąd prowadzi stały link przy każdym wierszu.

Weryfikacja sygnatury

wymaga planu prostabilna

GET /v1/weryfikuj/sygnatura?q=…

Czy sprawa o tej sygnaturze w ogóle istnieje — bariera przed halucynacją, wołana w czasie inferencji. Odpowiedź ma kilka stanów, nie dwa, bo „nie mamy" znaczy różne rzeczy. Orzeczeń SN i sądów powszechnych NIE mamy w komplecie (sądy powszechne to wybór z SAOS; SN do połowy 2016 r. z SAOS, później z repozytorium Sądu Najwyższego, repozytorium2.sn.pl, które nie publikuje wszystkiego, np. zarządzeń), więc ich brak nigdy nie znaczy „nie istnieje": „III CZP 999/14" (repertorium III CZP w 2014 r. nie przekroczyło u nas numeru 116 — odpowiedź podaje to w werdykcie: „najwyższy znany nam”) dostaje poza_zakresem z uwaga = numer_nietypowy — nie wiemy, ale numer jest podejrzany. Mocny sygnał zmyślenia (status brak) dajemy WYŁĄCZNIE dla repertoriów, które mamy w całości — Trybunał Konstytucyjny i KIO w zamkniętych rocznikach o pełnym pokryciu: „KIO 9876/24" leży wyraźnie ponad najwyższym numerem 2024 r. (5060) i nikt go nie cytuje. „III CZP 49/07" tekstu w bazie nie ma, ale cytują ją orzeczenia 58 sądów: status cytowana, istnieje. „ustawa o VAT" nie wygląda wcale na sygnaturę (status nie_rozpoznano).

Parametry

  • q — wymagany; JEDNA sygnatura w dowolnej pisowni (może nieść sąd i datę z cytatu), do 1000 znaków — dłuższe q przycinamy na granicy słowa, nigdy w środku sygnatury, i odpowiedź ma wtedy wejscie_przyciete: true (dalsza część nie była sprawdzana). Pusty → 400. Kilka różnych sygnatur w jednym q → 400 {"error": "multiple-signatures", "sygnatury": […]} — sprawdzane po weryfikacji klucza, ale przed naliczeniem kwoty (bez jej kosztu); listę wyślij do POST /v1/weryfikuj/sygnatury. Najpierw klucz: bez klucza albo z nieważnym dostajesz 401 / 403, zanim parametry zostaną sprawdzone (żadne 400 przed 401). Druga liczba bez repertorium też jest sygnaturą: „KIO 480/24 i 9999/24" i „K 36/09, 37/09" to po dwie. Sąd i data odczytane z q NIE są porównywane: status wynika z samego numeru, w_podanym_sadzie i data_zgodna są null, a uwaga_kontekstu cytuje brzmienie z tekstu obok sądu i daty, które mamy („porównaj sami"). Fragmenty podobne do sygnatury, których nie rozpoznaliśmy, werdykt wymienia z nazwy („nie sprawdziliśmy") — nigdy nie znikają po cichu. Jeden wyjątek na korzyść cytatu: gdy numer noszą sprawy kilku sądów (niejednoznaczne), a sąd i data z q pasują dokładnie do jednej z nich, odpowiedź to znaleziono z tą sprawą (sady nadal wymienia wszystkie, uwaga_kontekstu mówi, że wybór nastąpił na podstawie tekstu); pasują do żadnej albo do kilku → nadal niejednoznaczne.
  • sad — opcjonalny: rodzaj sądu (SUPREME | CONSTITUTIONAL_TRIBUNAL | NATIONAL_APPEAL_CHAMBER | COMMON | ADMINISTRATIVE) albo nazwa sądu lub miasto w dowolnej odmianie, do 120 znaków („Sąd Apelacyjny w Krakowie", „SO Warszawa-Praga", „SR dla Krakowa-Podgórza", „Sąd Okręgowy w Warszawie, I Wydział Cywilny", „Kraków"). Porównujemy pełną tożsamość sądu: szczebel + siedziba + dzielnica („Sąd Okręgowy w Warszawie" ≠ „SO Warszawa-Praga"); dopisek wydziału jest pomijany. Sam rodzaj sądu albo samo miasto pasuje szerzej. Tekst w stylu enumu, który enumem nie jest („SUPREMEE"), albo z operatorami (=; < >) → 400 bad-request. Podaj sąd z cytatu. Sygnatury sądów powszechnych powtarzają się między sądami (każdy sąd rejonowy ma swoje „I C 100/20"), a nasza baza to wybór z SAOS: gdy numer mamy tylko w INNYM sądzie powszechnym, a szczebel podanego sądu pasuje do repertorium, odpowiedź to poza_zakresem z uwaga = numer_w_innym_sadzie (nie wiemy — nie zmieniaj sądu w cytacie). Status inny_sad (sąd w cytacie jest błędny) dajemy, gdy numer mamy tylko w sądzie innego rodzaju (SN, TK, KIO) albo szczebel sądu przeczy repertorium („I ACa" przypisane sądowi rejonowemu).
  • data — opcjonalna: data orzeczenia z cytatu, RRRR-MM-DD. Gdy numer istnieje, data_zgodna mówi, czy któryś dokument sprawy ma tę datę (false = data w cytacie jest prawdopodobnie błędna — częsty błąd modeli); przy kilku sądach rozstrzyga, który pasuje. Inny format („9 kwietnia 2010", „2010-04-9") → 400 {"error": "bad-date"}. Data zapisana w samym q („wyrok KIO z 2 stycznia 2024 r., KIO 1000/24", „z 19.01.2023") nie jest porównywana — data_zgodna i data_podana pochodzą WYŁĄCZNIE z parametru data; datę z tekstu cytuje uwaga_kontekstu (a przy TK / KIO podpowiada mozliwa_literowka). TK i KIO: gdy numeru nie mamy, a tego dnia wydano sprawę tego repertorium o jeden znak od pytanej, mozliwa_literowka ją podaje („K 39/09" + 2012-01-11 → K 36/09).
  • limit — domyślnie 20, przycinany do 1–20. Dotyczy wyłącznie listy orzeczeń — prawdziwa liczba trafień jest w polu n.

Kształt odpowiedzi

{
  "zapytanie": <str>, "sad": <str|null>,
  "status": "znaleziono" | "niejednoznaczne" | "inny_sad" | "cytowana"
          | "brak" | "poza_zakresem"
          | "nie_rozpoznano",   // ten sam słownik co MCP i /v1/cytuj
  "w_podanym_sadzie": <bool|null>,      // tylko z parametru sad; sąd z tekstu q → null
  "data_zgodna": <bool|null>,           // tylko z parametru data; data z tekstu q → null
  "uwaga_kontekstu": <str>,             // tylko gdy q podaje sąd/datę: brzmienie z tekstu obok naszych danych
  "wejscie_przyciete": true,            // tylko gdy q przycięto do 1000 znaków (na granicy słowa)
  "data_podana": "RRRR-MM-DD",          // tylko przy poprawnym parametrze data — sprawdzona data
  "indeks_sn": [ { "data": <date>, "forma": <str|null> } ],  // tylko sprawa SN, data spoza naszych dokumentów: indeks repozytorium SN
  "uwaga": "numer_nietypowy" | "malo_cytowan"           // przy poza_zakresem
         | "numer_w_innym_sadzie"                      // przy poza_zakresem (sąd powszechny)
         | "numer_powszechny" | null,                  // przy znaleziono (sąd powszechny, bez sad)
  "mozliwa_literowka": [<str>],   // tylko TK/KIO przy data: sprawa z tego dnia o jeden znak od pytanej
  "n_cytowan": <int>,         // ile orzeczeń z naszej bazy cytuje tę sygnaturę
  "n_sadow_cytujacych": <int>,          // z ilu różnych sądów
  "inny_typ_sadu": true,      // tylko gdy mamy numer wyłącznie w sądzie innego rodzaju niż wpisany kod
  "werdykt": <str>,           // jedno zdanie po polsku, gotowe dla modelu
  "sprawdzono": <str|null>,   // kanoniczna postać faktycznie sprawdzona
  "n_sadow": <int>,
  "sady": [ { "sad": <str>, "court_type": <str>, "pasuje": <bool|null>,
              "n": <int>, "daty": [<date>] } ],
  "zakres": <str>,            // okno korpusu zdaniem (SAOS + UZP + TK + wybór NSA/WSA z CBOSA + SN z repozytorium2.sn.pl)
  "wersja_danych": { "korpus": <str>, "parser_sygnatur": <int>,
                     "zrodlo": <str>, "wygenerowano": <iso8601> },
  "stan": "znaleziono" | "niejednoznaczne" | "brak-w-tym-sadzie"
          | "brak-w-korpusie" | "nie-rozpoznano",
  "rozpoznano": <bool>, "istnieje": <bool|null>,
  "w_zakresie": <bool|null>, "n": <int>, "w_innym_sadzie": <bool>,
  "rozbior": {                // null przy stanie "nie-rozpoznano"
    "kanon": <str>, "kanon4": <str>, "slug": <str>,
    "wydzial": <str|null>, "wydzial_nr": <int|null>,
    "repertorium": <str>, "kod": <str>, "oddzial": <str|null>,
    "numer": <int>, "rok": <int>,
    "szczebel": <str>, "szczebel_opis": <str>,
    "typ": <str|null>, "typ_opis": <str|null>, "tk": <bool>,
    "znane_repertorium": <bool>, "wyjasnienie": <str>, "url": <str>
  },
  "orzeczenia": [ { "id": <int>,       // {id} tras /v1/orzeczenia/{id}/…
                    "slug": <str>, "case_number": <str>,
                    "court_type": <str>, "court_name": <str>, "izba": <str|null>,
                    "szczebel": <str>, "szczebel_opis": <str>,
                    "judgment_type": <str|null>, "judgment_date": <date|null>,
                    "url": <str>,
                    "zrodlo": "saos" | "uzp" | "tk",   // rejestr źródłowy orzeczenia
                    "zrodlo_url": <str> } ],     // strona orzeczenia w tym rejestrze
  "limit": <int>
}

Co znaczą pola

stanLEGACY — rozgałęziaj po status, nie po stan. znaleziono = dokładnie jedna sprawa · niejednoznaczne = ten sam numer nosi kilka spraw w różnych sądach (n > 1) · brak-w-tym-sadzie = tylko przy filtrze sad, nie ma tu, jest gdzie indziej · brak-w-korpusie = nie mamy tego numeru w korpusie — łączy trzy różne statusy (cytowana = istnieje, brak = sygnał zmyślenia, poza_zakresem = nie wiemy) · nie-rozpoznano = to w ogóle nie jest sygnatura.
statusznaleziono = jedna sprawa (ten sam sąd może mieć kilka dokumentów) · niejednoznaczne = numer nosi kilka spraw w różnych sądach (lista w sady) albo mamy go tylko w sądzie innego rodzaju niż wskazuje wpisany kod (inny_typ_sadu, np. „I CZ" = SN, a mamy „I Cz" sądu okręgowego) · inny_sad = sygnatura istnieje, ale tylko w sądzie innego rodzaju niż podany w sad (SN, TK, KIO) albo szczebel podanego sądu przeczy repertorium — sąd w cytacie jest błędny · cytowana = tekstu nie mamy, ale cytują tę sygnaturę orzeczenia co najmniej 3 różnych sądów albo co najmniej 5 orzeczeń z naszej bazy (TK: także co najmniej 2 sądy), a numer jest typowy dla repertorium i roku — istnieje; sąd, datę i treść sprawdź w źródle. W repertorium, które mamy w całości (TK, KIO), cytowany numer ponad najwyższym, jaki mamy, to poza_zakresem z uwaga = numer_nietypowy — zwykle literówka · brak = mocny sygnał zmyślenia, WYŁĄCZNIE w repertoriach, które mamy w całości (TK: K, P, SK, U, Kp…; KIO w zamkniętych rocznikach o pełnym pokryciu): numer wyraźnie wyższy (o 25 % + 10) niż najwyższy w tym roczniku i nikt go nie cytuje — SN i sądy powszechne nigdy nie dają brak · poza_zakresem = nie mamy tego orzeczenia — nie wiemy; uwaga mówi więcej: numer_nietypowy = numer ponad 3 × wyższy niż najwyższy znany nam w tym repertorium i roku (możliwa literówka w cytowaniu albo zmyślenie), malo_cytowan = cytowany, ale przez zbyt mało niezależnych źródeł, numer_w_innym_sadzie = podany sąd powszechny nie ma u nas tego numeru, inne sądy powszechne tak (to zwykle inne sprawy — nie wiemy, czy cytat jest poprawny) · znaleziono z uwaga = numer_powszechny = sąd powszechny bez parametru sad: ten sam numer może nosić sprawa innego sądu — porównaj sąd z cytatem · nie_rozpoznano = to nie jest sygnatura (200, istnieje: null).
istniejejedno znaczenie na każdej powierzchni (REST, MCP, /v1/cytuj): true = numer istnieje (znaleziono, niejednoznaczne, inny_sad, cytowana) · false = tylko przy brak · null = nie wiemy (poza_zakresem, nie-rozpoznano, albo trafienie wyłącznie w sądzie innego rodzaju — inny_typ_sadu). Przy inny_sad: istnieje = true i w_podanym_sadzie = false.
nliczba spraw z tym numerem z osobnego count exact — NIE długość tablicy orzeczenia. Ten sam numer („I C 100/20") nosi po kilkadziesiąt spraw w sądach rejonowych, a lista jest przycięta do limit.
w_zakresietrue = odpowiedź opiera się na naszym korpusie: numer ZNALEŹLIŚMY (znaleziono, niejednoznaczne, inny_sad) albo to mocny brak w repertorium, które mamy w całości. false = nasze dane tego nie rozstrzygają (cytowana, poza_zakresem, trafienie tylko w sądzie innego rodzaju). null przy nie_rozpoznano. Nie myl z „czy nietrafienie coś znaczy" — to mówi wyłącznie status brak.
n_sadowile sądów ma ten numer: odpowiadające (znaleziono / niejednoznaczne) albo — przy inny_sad — te inne (lista w sady).
data_zgodnatylko przy parametrze data i trafieniu: true = któryś dokument sprawy ma tę datę, false = żaden (werdykt to mówi), null = nie sprawdzano. Data zapisana w tekście q / sygn / pozycji NIGDY go nie ustawia (zob. uwaga_kontekstu). Sprawa SN: gdy żaden nasz dokument nie ma tej daty, sprawdzamy indeks repozytorium Sądu Najwyższego — pole indeks_sn podaje daty i formy dokumentów sprawy, a data_zgodna = true, gdy któryś ma datę z cytatu (data poprawna, tego dokumentu nie mamy w bazie).
data_podanatylko przy poprawnym parametrze data (RRRR-MM-DD), nigdy z daty w tekście: data, którą sprawdzono — echo wejścia, żeby wynik dało się przypisać do cytatu. Niepoprawna data nie jest sprawdzana (ostrzezenia), a pola wtedy nie ma.
uwaga_sadutylko gdy nazwy sądu z parametru sad (także pola sad pozycji paczki) nie rozpoznaliśmy, np. angielska lub zniekształcona nazwa: numer sprawdzono BEZ sądu, a status nigdy nie jest wtedy inny_sad — jedno zdanie wyjaśnienia. Podaj nazwę po polsku albo rodzaj sądu.
uwaga_kontekstuZasada: sąd i data odczytane z TEKSTU (q, sygn, akapit MCP, pozycja paczki z prozą) NIE wchodzą do werdyktu — status wynika z samego numeru, a w_podanym_sadzie i data_zgodna są w trybie tekstu ZAWSZE null (także gdy się zgadzają). To pole cytuje brzmienie z tekstu w cudzysłowie obok tego, co mamy, np. „W tekście obok sygnatury: „SA w Poznaniu", „5.03.2020". W bazie: Sąd Apelacyjny w Poznaniu (wyrok, 2019-12-19). Porównaj sami…" — przy kilku wzmiankach tej samej sygnatury wszystkie. true / false w w_podanym_sadzie i data_zgodna oraz inny_sad i uwaga numer_w_innym_sadzie dają WYŁĄCZNIE jawne parametry: sad / data w GET, pola sad / data pozycji w POST /v1/weryfikuj/sygnatury (i sad paczki), sad / data /v1/cytuj, sad / data MCP sprawdz_sygnature przy jednej sygnaturze. Też w /v1/cytuj, weryfikacji hurtowej i MCP.
werdyktpoza statusem werdykt mówi też: przy numerze ponad znany zakres — czy „najwyższy znany nam" numer to maksimum TEGO ROKU, czy całego rejestru we wszystkich latach; oraz wymienia z nazwy fragmenty podobne do sygnatury, których nie rozpoznaliśmy i nie sprawdziliśmy („podaj je z pełnym oznaczeniem, np. KIO 9999/24"). Te informacje są dziś tylko w zdaniu werdyktu (osobnych pól JSON nie ma).
wejscie_przycietetylko true i tylko gdy wejście (q, sygn) przekroczyło 1000 znaków: przycięliśmy je na granicy słowa, nigdy w środku sygnatury — dalsza część tekstu nie była sprawdzana. W weryfikacji hurtowej to samo jest wpisem w ostrzezenia pozycji.
w_innym_sadzietrue wyłącznie przy filtrze sad: w tym sądzie nie ma, w innym jest.
rozbior.szczebelszczebel WYWNIOSKOWANY z kodu repertorium. Każde trafienie niesie własny szczebel policzony z sądu — rozjazd między tymi dwoma jest sam w sobie sygnałem dla wołającego.
rozbior.znane_repertoriumfalse = kod repertorium spoza naszego słownika. Sygnatura nadal może być prawdziwa — to mówi tylko, że nie umiemy jej nazwać.
wskazowkajedno zdanie pomocy; jedzie wyłącznie przy stanie nie-rozpoznano.
sad_zapytanysąd, którego dotyczyło pytanie: WYŁĄCZNIE parametr sad; null, gdy go nie było — sąd odczytany z samego q („SA w Krakowie, I ACa 213/19") tu nie trafia (jest cytowany w uwaga_kontekstu).

Stan nie-rozpoznano zwracamy z kodem 200, nie 4xx — świadomie. Guardrail wołany w pętli inferencji musi rozgałęziać się po jednym kształcie odpowiedzi, a status 4xx klienci ponawiają jak błąd transportu.

Stan brak-w-korpusie sam w sobie nigdy nie znaczy „sprawa nie istnieje" — czytaj status: tylko brak to mocny sygnał zmyślenia (i tylko dla TK i KIO); cytowana znaczy „istnieje, ale tekstu nie mamy"; poza_zakresem znaczy „nie wiemy".

Orzeczeń SN i sądów powszechnych nie mamy w komplecie (sądy powszechne — wybór z SAOS; SN — do połowy 2016 r. z SAOS, później z repozytorium Sądu Najwyższego, repozytorium2.sn.pl) — dla nich nigdy nie powiemy „zmyślona". Werdykt mówi wtedy wprost: nie mamy tego orzeczenia, nie wiemy, czy istnieje — sprawdź w oficjalnym źródle.

Autorytet orzeczenia

wymaga planu probeta

GET /v1/orzeczenia/{id}/autorytet

Czy na ten wyrok nadal się powołują i czy przypadkiem nie został uchylony. Siła precedensu i percentyl, liczniki cytowań w obie strony oraz los orzeczenia z dowodem — ustalony z późniejszego orzeczenia, które nim rozporządziło. {id} to numeryczne orzeczenia.id, ta sama konwencja co /v1/orzeczenia/{id}/przepisy (zapisy „01" i „1x" są odrzucane).

Parametry

Brak — endpoint przyjmuje wyłącznie parametry ścieżki.

Kształt odpowiedzi

{
  "orzeczenie": { "id": <int>, "slug": <str>, "case_number": <str>,
                  "court_type": <str>, "court_name": <str>, "izba": <str|null>,
                  "judgment_type": <str|null>, "judgment_date": <date|null>,
                  "url": <str> },
  "ma_autorytet": <bool>,
  "autorytet": {              // null, gdy ma_autorytet = false
    "autorytet": <0..1>, "autorytet_percentyl": <0..100|null>,
    "poziom": "wysoki" | "sredni" | "niski" | null,
    "cytowane_n": <int>, "cytuje_n": <int>, "cytowane_poza_n": <int>,
    "los": "uchylone" | "zmienione" | "utrzymane" | "brak_danych",
    "los_opis": <str>,
    "los_zrodlo": "meta" | "tekst" | "cytowanie" | null,
    "los_zrodlo_opis": <str|null>,
    "los_dowod": { "dowody": [ { "przez_id": <int>, "przez_sygnatura": <str>,
                                 "przez_sad": <str|null>, "przez_data": <date|null>,
                                 "zrodlo": <str>, "zakres": "calosc" | "czesc",
                                 "cytat_znaki": <int|null>, "hash": <str>,
                                 "wersja": <str> } ],
                   "konflikt": <bool> },
    "ranga": <1|2|3>, "wersja_danych": <str>
  },
  "powod_braku": "brak-wiersza",   // tylko gdy ma_autorytet = false
  "powod_braku_opis": <str>,
  "uwaga": <str>,                  // tylko NSA/WSA: percentyl zawyżony przez dobór z CBOSA
  "pokrycie_losow": { "zmierzono": <date>, "wszystkich_orzeczen": <int>,
                      "brak_danych": <int>, "brak_danych_udzial": <0..1>, "opis": <str> },
  "zastrzezenia": [ <str>, <str>, <str> ],
  "wersja_danych": { "korpus": <date>, "zrodlo": <str>, "zastrzezenie": <str>, "warunki": <str> }
}

Co znaczą pola

ma_autorytetfalse = orzeczenie jest w bazie, ale nie ma jeszcze wiersza w rejestrze losów. To odpowiedź 200 z powod_braku, nie 404 — „orzeczenie jest, punktacji nie ma" to inny fakt niż „nie ma takiego orzeczenia" (ten drugi daje 404). Nie znaczy „autorytet zerowy".
autorytetPageRank po grafie cytowań orzeczenie → orzeczenie (d = 0,85, 30 iteracji), znormalizowany przez maksimum do zakresu 0–1. Świadomie bez wagi czasu.
autorytet_percentyl / poziompercentyl 0–100 w skali korpusu; poziom to etykieta z tych samych progów co rozety na stronie orzeczenia: wysoki ≥ 99, sredni ≥ 90, dalej niski. null, gdy orzeczenia nikt nie cytuje albo percentyla brak.
cytowane_n / cytuje_nkrawędzie przychodzące i wychodzące grafu cytowań między orzeczeniami.
cytowane_poza_nsurowe cytowane sygnatury, które nie zeszły na żadne orzeczenie (poza katalogiem albo niejednoznaczne). Liczone osobno, nigdy zgadywane.
los / los_opislos TEGO orzeczenia, ustalony z późniejszego orzeczenia, które nim rozporządziło. Niepewność zawsze daje brak_danych, nigdy zgadywanie.
los_zrodlometa = metadane SAOS (w tym korpusie w praktyce puste: 0 z 500 próbkowanych wierszy je niosło) · tekst = sentencja późniejszego orzeczenia · cytowanie = jak tekst, ale sygnatura była już krawędzią grafu. null przy brak_danych.
los_dowod.dowodydo pięciu dowodów. przez_id prowadzi do orzeczenia, które uchyliło — można pójść łańcuchem w górę i sprawdzić jego autorytet tym samym endpointem. hash to sha1 zdania źródłowego: wykrywa, że tekst źródłowy się zmienił.
los_dowod.konflikttrue, gdy dwa późniejsze orzeczenia mówią o tym samym co innego. Wtedy los zostaje brak_danych, a konflikt jest pokazany, nie ukryty.
uwaga / pokrycie_losowuwaga jedzie tylko przy orzeczeniach NSA/WSA: są w korpusie jako wybór z CBOSA (cytowane + uchwały NSA), więc percentyl liczony w skali całego korpusu jest dla nich zawyżony — porównuj cytowane_n. pokrycie_losow mówi, dla jakiej części korpusu los w ogóle ustalono (brak_danych_udzial to ułamek 0–1), żeby brak_danych nie czytać jako „nic się nie stało”.
zastrzezeniatrzy zdania o granicach tych liczb — jadą w KAŻDEJ odpowiedzi, nie tylko w tej dokumentacji.

cytowane_n to DOLNA GRANICA, nie liczba cytowań. Krawędź powstaje wyłącznie wtedy, gdy surowa sygnatura rozwiąże się do dokładnie jednego orzeczenia, a około 52 % surowych cytowań pozostaje nierozwiązanych (pole cytowane_poza_n).

Cytowanie nie znaczy akceptacji: bez etykiety traktowania liczba mówi tylko „powołano się N razy" — orzeczenie bywa cytowane po to, żeby się z nim nie zgodzić.

los = brak_danych znaczy „nie ustaliliśmy", a nie „nic się nie stało".

Cytatu nie wydajemy. W bazie jest zdanie sentencji późniejszego orzeczenia; endpoint zwraca wyłącznie jego długość (cytat_znaki) i skrót (hash), bo dosłowne zdanie z sentencji jest treścią orzeczenia, a treści nie serwujemy w żadnym planie. Audyt robi się przez przez_id.

Sieć cytowań orzeczenie ↔ orzeczenie

wymaga planu probeta

GET /v1/orzeczenia/{id}/cytowania

Osobny graf od darmowego: nie „orzeczenie powołuje artykuł", tylko „orzeczenie powołuje orzeczenie" — z tego biorą się łańcuchy precedensów. 1 410 700 krawędzi (stan na 2026-11-16). Oba kierunki kosztują tyle samo (klucz główny i indeks odwrotny), więc domyślnie zwracamy oba naraz.

Parametry

  • kierunek — cytuje | cytowane_przez. Pominięty = oba kierunki naraz (pole kierunek przyjmuje wtedy wartość "oba"). Inna wartość → 400.
  • limit — domyślnie 30, przycinany do 1–200.
  • offset — domyślnie 0, przycinany do 0–5000.

Kształt odpowiedzi

{
  "orzeczenie": { "id": <int>, "slug": <str>, "case_number": <str>,
                  "court_type": <str>, "court_name": <str>, "izba": <str|null>,
                  "judgment_date": <date|null>, "url": <str> },
  "kierunek": "oba" | "cytuje" | "cytowane_przez",
  "cytuje":         { "zwrocone": <bool>, "total": <int>, "items": [ … ] },
  "cytowane_przez": { "zwrocone": <bool>, "total": <int>, "items": [ … ] },
  "limit": <int>, "offset": <int>
}

// items[]:
{ "id": <int>, "slug": <str>, "case_number": <str>, "court_type": <str>,
  "court_name": <str>, "izba": <str|null>, "judgment_date": <date|null>, "url": <str> }

Co znaczą pola

cytujeto orzeczenie jest stroną cytującą — na kogo ono się powołuje.
cytowane_przezto orzeczenie jest stroną cytowaną — kto powołuje się na nie.
zwroconefalse znaczy „o ten kierunek nie było pytania", a nie „pusto". Pusta tablica przy pominiętym kierunku dałaby się pomylić z zerem krawędzi, dlatego jest to osobne pole.
totalz count exact i liczony ZAWSZE dla obu kierunków, także dla pominiętego — żeby było wiadomo, ile Cię ominęło. Długość strony nigdy nie jest totalem.
sortowanierosnąco po id drugiej strony krawędzi, nie po dacie: paginacja ma być stabilna między stronami.

Krawędź powstaje TYLKO wtedy, gdy surowa sygnatura z rejestru pasuje do dokładnie jednego wiersza katalogu. Sygnatura nie jest unikalna („II K 123/20" istnieje dziesiątki razy), więc dopasowania niejednoznaczne są świadomie pomijane, nigdy zgadywane. Konsekwencja dla Ciebie: brak krawędzi ≠ brak cytowania w tekście wyroku.

Surowej listy cytowanych sygnatur nie wystawiamy — byłby to inny kontrakt („co wyrok cytuje wg rejestru", a nie „co udało się rozwiązać"). Autocytowanie nigdy nie jest krawędzią.

Backfill jest wznawialny, więc totale rosną w czasie. Zero nie jest faktem trwałym.

Rozstrzygnięcie per orzeczenie

wymaga planu probeta

GET /v1/orzeczenia/{id}/wynik

To, co warstwa darmowa oddaje wyłącznie w agregacie — tu per wiersz i bogatsze: instancja, wynik, wynik odwołania, rodzaj roszczenia oraz kwota żądana obok zasądzonej. Udział zasądzonego w żądanym liczymy po stronie serwera, żeby każdy klient nie liczył go inaczej.

Parametry

Brak — endpoint przyjmuje wyłącznie parametry ścieżki.

Kształt odpowiedzi

{
  "orzeczenie": { "id": <int>, "slug": <str>, "case_number": <str>,
                  "court_type": <str>, "court_name": <str>, "izba": <str|null>,
                  "judgment_date": <date|null>, "judgment_type": <str|null>,
                  "url": <str> },
  "ma_wynik": <bool>,
  "wynik": {                  // null, gdy ma_wynik = false
    "wynik": "uwzglednienie" | "czesciowe" | "oddalenie" | "odrzucenie"
             | "umorzenie" | "uchylenie_i_przekazanie" | "zmiana"
             | "utrzymanie" | "inne" | "nie_da_sie_ustalic",
    "wynik_scalony": <ten sam słownik po scaleniu>,
    "instancja": "pierwsza" | "apelacja" | "kasacja" | "inna",
    "wynik_odwolania": "oddalenie_srodka" | "zmiana" | "uchylenie"
                       | "czesciowe" | "nd",
    "rodzaj_roszczenia": <str|null>,
    "kwota_zadana": <number|null>, "kwota_zasadzona": <number|null>,
    "waluta": <str|null>, "udzial_zasadzony": <number|null>,
    "pewnosc": "wysoka" | "srednia" | "niska",
    "zrodlo": "regula" | "llm", "labeled_at": <iso8601|null>
  },
  "uwaga": <str>              // ostrzeżenie o pochodzeniu etykiet — w KAŻDEJ odpowiedzi
}

Co znaczą pola

ma_wynikfalse = mamy orzeczenie, nie mamy etykiety. Zwracamy 200, bo 404 znaczyłoby „nie ma takiego orzeczenia" i pozwoliłoby wywnioskować etykietę, której nie ma.
wynik_scalonyten sam słownik po kubełkach równoważności: utrzymanie → oddalenie (utrzymanie zaskarżonego), zmiana → czesciowe (ingerencja w meritum). Tego używają nasze własne statystyki.
wynik_odwolania„nd" nie znaczy „brak danych" — znaczy orzeczenie pierwszej instancji, w którym odwołania po prostu nie ma.
rodzaj_roszczeniasłownik: zadoscuczynienie, odszkodowanie, oba, zachowek, kara_umowna, bezpodstawne_wzbogacenie, wynagrodzenie_za_prace, odszkodowanie_komunikacyjne, zaplata_z_umowy, alimenty, renta, swiadczenie_zus, inne, nd. Wiersze z zrodlo = regula mają tu null z założenia.
udzial_zasadzonykwota_zasadzona ÷ kwota_zadana, zaokrąglone do czterech miejsc. null, gdy którejś kwoty brak albo żądanie jest zerowe. Wartość > 1 jest możliwa (zasądzono ponad żądanie główne) i jest sygnałem, że tę parę kwot warto obejrzeć, a nie liczbą do uśredniania.
pewnoscwysoka | srednia | niska. Zapisana, nie filtrowana: to warstwa analityczna decyduje, których progów użyje. Statystyki publikowane przez Prawnet biorą wyłącznie pewnosc = wysoka.
zrodloregula = etykieta z silnika regułowego, llm = z modelu.
uwagaostrzeżenie o pochodzeniu etykiet jedzie w każdej odpowiedzi, także przy ma_wynik = false.

Pokrycie: 398 090 wierszy wobec 659 155 orzeczeń w korpusie, czyli 60,3 % — nie całość. Etykiety są wyprowadzone regułami, a część (zrodlo = llm) modelem językowym. Etykiety sprawdzono na próbkach, nie w całości, i dotąd wyłącznie automatycznie: ocena modelem jako sędzią na 55 etykietach o wysokiej pewności — 96,4 % trafności; kontrola próbki 72 etykiet przez audytorów AI (7.11.2026; próba celowa, warstwowa; przedział nie jest reprezentatywny) — wynik trafny w 95,8 %, kwota w 87,5 % (n=32); kolejna próbka 40 etykiet: rodzaj roszczenia (zadośćuczynienie / odszkodowanie) jednoznacznie trafny w 77,5 % (95% CI 62–88 %) — to najsłabsze ogniwo: w większości wyroków sentencja nie nazywa rodzaju i decydują przepisy cytowane w orzeczeniu. Kontrole dotyczyły wersji reguł sprzed zmian z 7.11.2026. Ręczna walidacja na próbie losowej w toku. Nie są przejrzane w całości przez człowieka; pole pewnosc jedzie w każdym wierszu i to po nim należy się rozgałęziać (pewnosc = wysoka: 345 361 wierszy).

Kwoty są w większości BEZ TYPU. kwota_zasadzona jest w 48 643 wierszach, rodzaj_roszczenia tylko w 24 266, kwota_zadana tylko w 2675, a obie kwoty naraz w 935. Dlatego udzial_zasadzony jest zwracany rzadko — z założenia — a median per rodzaj roszczenia z tego zbioru policzyć się NIE DA.

Nie każda kwota jest sumowalna: alimenty i renta to kwoty MIESIĘCZNE, a przy swiadczenie_zus sąd przyznaje PRAWO, nie sumę. Endpoint tej flagi nie zwraca, więc rozróżnienie jest po Twojej stronie. Znany defekt do poprawy: 192 wiersze niosą kwotę przy roszczeniu z rodzaju „bez kwoty".

Pola uzasadnienie_wyniku nie zwracamy: to dosłowny cytat z sentencji, czyli treść orzeczenia. /v1 wystawia metadane i wartości pochodne, nigdy tekst.

Brzmienie przepisu na dzień

wymaga planu probeta

GET /v1/przepisy/{rok}/{poz}/{art}/brzmienie?na=YYYY-MM-DD

Jak ten artykuł brzmiał w danym dniu. Bez parametru na zwracamy KALENDARZ — listę wersji z zakresami obowiązywania, bez treści — bo pytanie „jakie daty w ogóle macie?" jest tak samo uprawnione jak pytanie o konkretny dzień i nie może kończyć się błędem. Historia pochodzi z łańcucha obwieszczeń o tekście jednolitym, a najnowszą migawką jest żywy tekst Kancelarii Sejmu.

Parametry

  • na — opcjonalna data YYYY-MM-DD, walidowana kalendarzowo (2019-02-30 → 400). Z nią dostajesz brzmienie obowiązujące tego dnia WRAZ z treścią; bez niej sam kalendarz wersji.
  • ścieżka — rok 1900–2100, pozycja 1–999999, artykuł w zapisie kanonicznym (449-1 = art. 449¹). Poza zakresem → 400.

Kształt odpowiedzi

{
  "przepis": { "y": <int>, "p": <int>, "art": <str>, "url": <str> },
  "pokrycie": <bool>, "pokrycie_opis": <str>, "akt_w_warstwie": <bool>,
  "na": <date|null>, "liczba_wersji": <int>,
  "wersja": { … , "tresc": <str|null> },   // tylko przy ?na=; null, gdy dzień
                                           // jest wcześniejszy niż nasza historia
  "wersje": [ {                            // kalendarz — zawsze bez treści
      "nr": <int>, "od": <date|null>, "do": <date|null>,
      "od_szacowane": <bool>, "od_uwaga": <str|null>, "aktualna": <bool>, "przyszla": <bool>,
      "od_najwczesniej": <date|null>, "pewne_od": <date|null>,
      "typ": "pierwotna" | "zmieniony" | "dodany" | "uchylony",
      "typ_opis": <str>, "zrodlo_zmiany": <str|null>, "zrodlo_tj": <str|null>,
      "znaki": <int>,
      "nieustalone": <str>                 // tylko gdy przyszłego brzmienia nie dało się zbudować
  } ],
  "przyszla_zmiana": [ { … jak wersja, z "tresc" } ],   // nowelizacje z od > dziś; [] gdy brak
  "data_szacowana": <bool>,                // tylko przy ?na=: dzień leży w oknie niepewności dat
  "uwaga": <str|null>,
  "wersja_danych": { "korpus": <date>, "zrodlo": <str>, "zastrzezenie": <str>, "warunki": <str> }
}

Co znaczą pola

nr1 = NAJSTARSZE brzmienie, jakie mamy — nie „pierwotne" w sensie historycznym. Numery rosną w czasie.
odpierwszy dzień tego brzmienia. null = „od najstarszej migawki", czyli początek jest NIEZNANY, a nie „od zawsze".
dodzień, w którym zaczyna się NASTĘPNE brzmienie (górna granica wyłączna). null = brzmienie nadal aktualne.
od_szacowane / od_uwagatrue, gdy przypis obwieszczenia nie podał dnia wejścia w życie i za datę początkową podstawiono DATĘ OBWIESZCZENIA o tekście jednolitym. To oszacowanie, nie odczyt — rzeczywisty dzień wejścia w życie może się od niej różnić w obie strony (od_najwczesniej zawęża okno od dołu). Wystawiamy je przy każdej takiej wersji, bo milczenie tutaj znaczyłoby podanie szacunku jako faktu.
aktualnatrue = brzmienie obowiązujące w dniu zapytania. Ogłoszone nowelizacje z odroczonym wejściem w życie są zwracane osobno w przyszla_zmiana, nigdy jako aktualne.
data_szacowana / od_najwczesniej / pewne_odgdy dzień wejścia w życie jest szacowany, każda data w oknie [od_najwczesniej, od) ma data_szacowana: true — rzeczywista data może się różnić w obie strony. pewne_od to pierwszy dzień, od którego brzmienie obowiązuje NA PEWNO (np. obwieszczenie wydrukowało przepis dodany, który wchodził w życie później); dni w [od, pewne_od) także mają data_szacowana: true i uwagę.
typ / typ_opispierwotna (najstarsze brzmienie w naszym łańcuchu migawek — NIE brzmienie z dnia uchwalenia; artykuł mógł być wcześniej zmieniany) | zmieniony | dodany | uchylony. Wersja uchylona nie ma treści. Dla artykułu dodanego nowelizacją data sprzed jego początku daje wersja: null i uwagę, że artykuł jeszcze nie obowiązywał.
zrodlo_zmiany / zrodlo_tjakt nowelizujący z przypisu („Dz.U. 2023 poz. 1615"; null, gdy przypis go nie wskazał) oraz ELI migawki tekstu jednolitego, z której odczytano brzmienie („DU/2024/1061"). Razem to materiał do audytu odpowiedzi.
znaki / trescznaki to długość brzmienia w znakach; tresc jedzie WYŁĄCZNIE w polu wersja przy?na=. Kalendarz jest bez treści z rozmysłu — pełne teksty wszystkich wersji kodeksowego artykułu to dziesiątki kB na wywołanie.
pokrycie / akt_w_warstwiepokrycie = false z akt_w_warstwie = true znaczy „akt jest objęty warstwą, ale dla tego artykułu nie mamy żadnego brzmienia"; akt_w_warstwie = false znaczy „ten akt jest w całości poza warstwą". To dwa różne fakty i odpowiedź je rozróżnia.

Warstwa obejmuje 10 najczęściej cytowanych aktów (8 kodeksów, Ordynacja podatkowa i ustawa o ochronie praw lokatorów), nie cały korpus: 10 648 wierszy wobec 169 796 artykułów w bazie aktów. Pusta odpowiedź znaczy „ten akt lub artykuł jest poza warstwą", a NIE „ten artykuł nigdy się nie zmienił". To są fakty przeciwstawne i nie wolno ich pomylić.

Kodeks postępowania administracyjnego (Dz.U. 1960 poz. 168) jest poza warstwą „brzmienie na dzień” (pokrycie: false, akt_w_warstwie: false) — jego aktualną treść zwraca tresc_przepisu / tekst aktu, ale bez historii wersji.

Zakres tekstów (tresc_przepisu i strony aktów): od 2025 r. ELI nie publikuje HTML aktów, więc teksty aktów z lat 2025–2026 mamy tylko wtedy, gdy Kancelaria Sejmu opublikowała tekst ujednolicony (część ustaw), a dla rozporządzeń — gdy odczytaliśmy tekst jednolity z PDF-u obwieszczenia (pole tekst_jednolity.z_pdf; załączniki tylko w PDF). Dla pozostałych nowych aktów zwracamy nie_znaleziono z linkiem do oficjalnego PDF. Rozporządzenie bez tekstu jednolitego zwracamy w brzmieniu pierwotnym z tekst_pierwotny_zmieniany: true i bez obowiazuje_na; akt uchylony — z akt_obowiazuje: false i uchylony_od.

BETA. Historia pochodzi z łańcucha obwieszczeń o tekście jednolitym, więc zmiany sprzed najstarszego obwieszczenia w bazie mogą być niewidoczne, a daty początku bywają SZACOWANE — każda taka data jest oznaczona (od_szacowane / data_szacowana) i nie należy jej czytać jak odczytu z Dz.U. Gdy podana data jest wcześniejsza niż początek najstarszego brzmienia, jakie trzymamy, wersja jest null, a uwaga mówi to wprost.

Nowelizacje z odroczonym wejściem w życie, które znamy z tekstu, zwracamy osobno od brzmienia obowiązującego — nie wplatamy ich w nie. Dla daty w przyszłości zwracamy brzmienie, które według dzisiejszego stanu prawa ma obowiązywać tego dnia (z ogłoszonymi nowelizacjami), z uwagą, które brzmienie podaliśmy i dlaczego.

Błąd nie jest tym samym co pusto: awaria odczytu daje 503 api-not-ready z nagłówkiem Retry-After, nigdy pustej listy udającej brak pokrycia.

Mediany czasu wg repertorium i szczebla

wymaga planu probeta

GET /v1/statystyki/czas

Mediany liczby dni w podziale na repertorium i szczebel sądu, ZAWSZE z wielkością próby, obok rozkładu rozstrzygnięć dla tej samej komórki. Mała tabela — 308 komórek (stan na 2026-11-16).

Parametry

  • repertorium — kod repertorium, porównywany DOKŁADNIE i z uwzględnieniem wielkości liter („Kz" ≠ „KZ"). Litery, opcjonalnie z ukośnikiem siedziby lub organu: C, ACa, NSNc, SA/Wa, KIO/UZP. Nieznany kod oddaje pustą listę, a nie 400; kod o złym kształcie → 400.
  • szczebel — SR | SO | SA | SN | TK | KIO | NSA | WSA | inne. Inna wartość → 400.
  • limit — domyślnie 200, przycinany do 1–500.
  • offset — domyślnie 0, przycinany do 0–5000.

Kształt odpowiedzi

{
  "filtry": { "repertorium": <str|null>, "szczebel": <str|null> },
  "metoda": { "mierzy": <str>, "nie_mierzy": <str>, "dokladnosc": "rok",
              "min_probka_mediany": 30, "zrodlo": <str>,
              "mediana_szac": { "mierzy": <str>, "zrodlo": <str>, "min_probka": <int>,
                                "przyciete": <str>, "okres": <str> },
              "rozstrzygniecia": { "pewnosc": "wysoka", "min_probka": 20, "zrodlo": <str>, … } },
  "total": <int>, "limit": <int>, "offset": <int>,
  "komorki": [ {
      "repertorium": <str>, "repertorium_nazwa": <str|null>,
      "typ": <str|null>, "typ_label": <str|null>, "typ_label_en": <str|null>,
      "szczebel": <str>, "szczebel_label": <str>, "szczebel_label_en": <str>,
      "mediana_dni": <int|null>, "n_dni": <int>, "n_orzeczen": <int>,
      "mediana_dni_szac": <int|null>, "n_szac": <int|null>,
      "okres_szac": { "od": <int>, "do": <int> } | null,
      "mediana_dni_szac_wszystkie_lata": <int|null>, "n_szac_wszystkie_lata": <int|null>,
      "n_wszystkie": <int|null>, "udzial_przycietych": <0..1|null>,
      "n_wszystkie_wszystkie_lata": <int|null>, "udzial_przycietych_wszystkie_lata": <0..1|null>,
      "mediana_szac_uwaga": <str|null>,
      "mediana_uwaga": <str|null>,
      "rozstrzygniecia": <{ etykieta: liczba }|null>, "n_wynik": <int>,
      "pierwszy_rok": <int|null>, "ostatni_rok": <int|null>,
      "url": <str|null>, "zaktualizowano": <iso8601|null>
  } ],
  "wersja_danych": { "korpus": <date>, "zrodlo": <str>, "zastrzezenie": <str>, "warunki": <str> }
}

Co znaczą pola

metodablok wyjaśniający, co ta liczba mierzy — jedzie w KAŻDEJ odpowiedzi, nie tylko w dokumentacji. Liczba bez tego zdania zostanie przeczytana jako długość postępowania.
mediana_dnimediana liczby dni między 1 stycznia roku z sygnatury a datą orzeczenia. null, gdy próba jest poniżej progu 30 datowanych orzeczeń.
mediana_dni_szac / n_szacSZACOWANA mediana dni od wpływu sprawy do orzeczenia: datę wpływu szacujemy z pozycji numeru sprawy w roku rejestracji (ta sama liczba co na stronach „ile trwa sprawa w sądzie” i /sygnatura/{kod}). n_szac to próba szacunku. null, gdy dla komórki nie ma szacunku — wtedy zostaje tylko mediana_dni. Pole dodane 2026-10-23; mediana_dni bez zmian.
n_dni / n_orzeczenn_dni to liczba orzeczeń, które w ogóle dało się wydatować; n_orzeczen to cała komórka. Mediana nigdy nie jest podawana bez próby.
n_wszystkie / udzial_przycietych / mediana_szac_uwagan_szac liczy sprawy mierzalne; n_wszystkie — wszystkie sprawy okna, także te, których szacowany początek wypada po orzeczeniu. udzial_przycietych to ich udział jako UŁAMEK 0–1 (0,01 = 1 %), nie procent. Sprawy przycięte to z konstrukcji metody sprawy najszybsze, więc mediana_dni_szac jest GÓRNĄ GRANICĄ mediany wszystkich spraw — od progu podanego w metoda.mediana_szac.przyciete pole mediana_szac_uwaga mówi to wprost. Pola *_wszystkie_lata opisują całą komórkę, nie okno okres_szac; null = migawka nie niesie tej liczby.
mediana_uwagamówi, DLACZEGO mediany nie ma: próba poniżej progu albo brak wartości w danych dla tej komórki.
rozstrzygniecia / n_wynikrozkład rozstrzygnięć dla tej samej komórki, publikowany dopiero od 20 etykiet — niżej null. Jedzie obok mediany, bo „ile trwa" bez „czym się kończy" bywa czytane jako obietnica wyniku.
urllink do strony repertorium; null, gdy suma kodu po wszystkich szczeblach nie przekracza progu istnienia strony — nie linkujemy w 404. Sama komórka jest zwracana zawsze.
totalliczba komórek pasujących do filtrów, z count exact — nigdy długość strony wyników.

mediana_dni to NIE jest czas trwania sprawy. Jest to mediana liczby dni między 1 stycznia roku z sygnatury a datą orzeczenia — to NIE jest czas od wniesienia sprawy do wyroku, bo sygnatura nie niesie miesiąca wpływu. Dokładność: rok, a punktem zerowym jest początek roku rejestracji, nie dzień wniesienia pozwu. Przybliżenie czasu od wpływu daje osobne pole mediana_dni_szac — szacunek, nie data z akt.

Progi są te same, co na stronach sygnatur: mediany nie publikujemy poniżej 30 datowanych orzeczeń, a rozkładu rozstrzygnięć poniżej 20 etykiet. API i strona nie mogą podać dwóch różnych liczb dla tej samej komórki.

Rozkład rozstrzygnięć dziedziczy wszystkie zastrzeżenia etykiet — patrz endpoint rozstrzygnięcia per orzeczenie powyżej.

Pusto to nie błąd, a błąd to nie pusto: awaria bazy daje 503 api-not-ready z Retry-After, nigdy odpowiedzi „nie mamy takich komórek".

Orzeczenia wiodące do przepisu

wymaga planu prostabilna

GET /v1/przepisy/{rok}/{poz}/{art}/wiodace

Które kilka orzeczeń na tym przepisie waży. Sąsiednia darmowa trasa …/orzeczenia oddaje WSZYSTKIE orzeczenia cytujące przepis, od najnowszych — przy art. 415 k.c. to dziesiątki tysięcy wierszy, których nie przeczyta ani prawnik, ani model, a „najnowsze" nie znaczy „najważniejsze". Nowych danych tu nie ma: to złączenie krawędzi grafu (przepis ← orzeczenie) z tabelą autorytetu, uszeregowane w bazie. Krótka lista, nie zbiór do stronicowania — dlatego nie ma parametru offset.

Parametry

  • limit — domyślnie 10, przycinany do 1–20. To cała lista, nie strona — offsetu nie ma z rozmysłu: „strona 7 orzeczeń wiodących" nie jest pytaniem, na które ta trasa odpowiada.
  • sad — opcjonalny filtr sądu: SUPREME | CONSTITUTIONAL_TRIBUNAL | NATIONAL_APPEAL_CHAMBER | COMMON | ADMINISTRATIVE. Inna wartość → 400.
  • min_cytowan — opcjonalny próg 0–10000, walidowany OSTRO (w odróżnieniu od limit, który jest przycinany): min_cytowan=x daje 400, a nie po cichu listę bez progu. Milcząco zdjęty filtr byłby kłamstwem o treści odpowiedzi, którego nie dałoby się zauważyć.
  • ścieżka — rok 1900–2100, pozycja 1–999999, artykuł w zapisie kanonicznym (449-1 = art. 449¹). Poza zakresem → 400.

Kształt odpowiedzi

{
  "przepis": { "y": <int>, "p": <int>, "art": <str>, "url": <str> },
  "ranking": { "wg": "autorytet", "opis": <str>,
               "dlaczego_nie_cytowane_n": <str>,
               "pula": <str>, "pula_uwaga": <str> },
  "total": <int>,       // WSZYSTKIE orzeczenia cytujące przepis
  "wgSadu": { "<court_type>": <int> },
  "filtry": { "sad": <str|null>, "min_cytowan": <int> },
  "okno": { "zadane": <int>, "kandydatow": <int>, "caly_zbior": <bool> },
  "items": [ {
      "id": <int>, "slug": <str>, "case_number": <str>,
      "court_type": <str>, "court_name": <str>, "izba": <str|null>,
      "judgment_type": <str|null>, "judgment_date": <date|null>,
      "url": <str>,
      "autorytet": { "autorytet": <0..1>,
                     "autorytet_percentyl": <0..100|null>,
                     "poziom": "wysoki" | "sredni" | "niski" | null,
                     "cytowane_n": <int>, "cytuje_n": <int|null>,
                     "cytowane_poza_n": <int|null>,
                     "ranga": <1|2|3>, "wersja_danych": <str|null> },
      "los_znany": <bool>,
      "los": "uchylone" | "zmienione" | "utrzymane" | "brak_danych",
      "los_opis": <str>,
      "los_zrodlo": "meta" | "tekst" | "cytowanie" | null,
      "los_zrodlo_opis": <str|null>,
      "autorytet_url": <str>       // pełny dowód losu — jedno wywołanie dalej
  } ],
  "limit": <int>,
  "pokrycie_losow": { "zmierzono": <date>, "wszystkich_orzeczen": <int>,
                      "brak_danych": <int>, "brak_danych_udzial": <number>,
                      "w_tej_liscie": { "znane": <int>, "z": <int> },
                      "opis": <str> },
  "zastrzezenia": [ <str>, … ]     // sześć zdań, w KAŻDEJ odpowiedzi
}

Co znaczą pola

ranking.wg / ranking.opisklucz sortowania: autorytet malejąco, remis rozstrzyga cytowane_n malejąco, a na końcu orzeczenie_id rosnąco. Liczy to baza, nie klient — w pamięci dałoby się przesortować tylko okno, nie pulę, więc wynik byłby inny.
ranking.pula / pula_uwagapula kandydatów to orzeczenia o randze ≤ 2. Ranga 3 — w tym KAŻDE orzeczenie bez pobranej treści — kandydatem nie jest. To zawężenie pomiaru jedzie w odpowiedzi, a nie tylko w tej dokumentacji.
totalile orzeczeń W OGÓLE cytuje ten przepis (count distinct wprost na krawędziach, licznik żywy). To mianownik do „pokazujemy 10 z …" i jest SZERSZY niż pula rankingu.
wgSadujedyny klucz camelCase w tej odpowiedzi, celowo: sąsiednie trasy …/orzeczenia i …/stats na tym samym przepisie nazywają go dokładnie tak, a klient porównuje trzy odpowiedzi pole w pole.
oknotylko przy min_cytowan: próg działa po stronie API, na OKNIE kandydatów, a nie na całej puli. caly_zbior = true znaczy, że pula skończyła się w oknie, czyli próg objął ją w całości.
autorytet.cytowane_nliczba cytowań jako WIDOCZNY DOWÓD, po którym możesz ocenić kolejność — nie jako klucz sortowania. Jest dolną granicą: krawędź powstaje tylko dla jednoznacznej sygnatury.
los_znanylos!== "brak_danych", podane wprost, żeby nie porównywać stringów. To jest dokładnie ta oś, na której „nie ustaliliśmy" bywa czytane jako „nic się nie stało".
autorytet_urlpełen dowód losu (przez_id, przez_sygnatura, hash) jest o jedno wywołanie dalej — nie duplikujemy go tutaj, żeby nie powstały dwie wersje tej samej rzeczy.
pokrycie_losowile orzeczeń w całym korpusie ma los = brak_danych, plus to samo dla tej listy. Bez tej liczby brak_danych przy pozycji czyta się jak czyste konto.
zastrzezeniasześć zdań o granicach tych liczb — jadą w KAŻDEJ odpowiedzi, nie tylko w tej dokumentacji.

NIE sortujemy po cytowane_n, choć to byłoby oczywiste. Surowa liczba cytowań waży każde powołanie tak samo: orzeczenie powołane 40× w szablonowych uzasadnieniach sądów rejonowych wyprzedziłoby to powołane 12× przez SN. Gorzej — jest dolną granicą, a jej ubytek (~52 % cytowań nierozwiązanych) NIE jest równomierny: zależy od tego, jak dany sąd formatuje sygnatury. Sortowanie po niej wpisałoby artefakt formatowania w „ważność prawną".

NIE sortujemy też po losie: 98,40 % korpusu ma los = brak_danych, więc ranking po losie uszeregowałby 1,60 % zbioru i uznał całą resztę za równą. Los mimo to jedzie przy KAŻDEJ pozycji, bo „to wiodące orzeczenie zostało uchylone" jest najcenniejszym zdaniem, jakie ta trasa może powiedzieć.

Ograniczenie puli, które trzeba znać przed integracją: brane pod uwagę są WYŁĄCZNIE orzeczenia o randze ≤ 2, a orzeczenie bez pobranej treści ma rangę 3. Mocno cytowany wyrok, którego tekstu nigdy nie ściągnęliśmy, NIE POJAWI SIĘ tu nigdy — choćby był cytowany najczęściej ze wszystkich. To zawęża pomiar i nie jest tym samym, co „nie jest wiodący".

„Wiodące" znaczy tu: najwyższy autorytet cytowaniowy w NASZYM rozwiązanym grafie cytowań. To pomiar, a nie opinia prawna — i nie to samo, co „przełomowe" czy „wiodące" w sensie doktrynalnym. Remis po cytowane_n, a potem po id, jest konieczny, nie kosmetyczny: przy dole rozkładu autorytetu remisów są tysiące i bez tego to samo zapytanie dawałoby dwie różne listy.

Treści orzeczeń nie ma i tutaj: podsumowania i fragmenty odcinamy, a dowodu losu (niesie zdanie sentencji) po prostu nie pobieramy. Odpowiedź jest prywatna i nie jest cache’owana po stronie klienta, ale dane pod spodem trzymamy przez godzinę w cache’u serwera kluczowanym WYŁĄCZNIE parametrami korpusu — bez czegokolwiek z Twojego klucza. Wynik może być do godziny starszy niż baza; źródło zmienia się i tak raz na kilka dni.

Weryfikacja sygnatur hurtem

wymaga planu prostabilna

POST /v1/weryfikuj/sygnatury

Ten sam guardrail co wyżej, jedno wywołanie zamiast dziesięciu tysięcy: laboratorium sprawdza cytaty całego przebiegu ewaluacji, a nie jedną sygnaturę w pętli inferencji. Do 100 pozycji na żądanie. Pozycja w wyniki ma DOKŁADNIE kształt pojedynczej odpowiedzi /v1/weryfikuj/sygnatura minus trzy pola niezmienne dla całej paczki (zakres, wersja_danych, limit), które stoją raz w kopercie — jeden parser obsługuje oba wejścia.

Kształt żądania

POST /v1/weryfikuj/sygnatury
Content-Type: application/json

{ "sygnatury": ["III CZP 100/14", "KIO 9876/24", "ustawa o VAT",
                 { "sygnatura": "I ACa 1890/22", "sad": "SA w Łodzi", "data": "2023-01-19" }],
  "limit": 3 }

Ciało powyżej to poprawny JSON — można je wkleić bez zmian. Opcjonalne "sad" (np. "SUPREME") filtruje CAŁĄ paczkę; "limit" to długość listy trafień w jednej pozycji. Równoważnie wolno wysłać gołą tablicę, np. ["KIO 1000/24", "I ACa 1890/22"] (wtedy sad = null, limit = 3).

Pola ciała żądania

  • sygnatury — wymagane; niepusta tablica, do 100 pozycji. Pozycja to ciąg ALBO obiekt {"sygnatura": "…", "sad": "…", "data": "RRRR-MM-DD"} — sąd i data z KONKRETNEGO cytatu (para sąd + numer to najczęstszy błąd modeli). Pozycję dłuższą niż 1000 znaków przycinamy na granicy słowa (nigdy w środku sygnatury) i mówimy o tym w ostrzezenia. Negatyw (inny_sad, numer_w_innym_sadzie, w_podanym_sadzie / data_zgodna false) dają tylko pola sad / data pozycji (i sad całej paczki) — sąd i data z tekstu pozycji nie są porównywane (pola null), tylko cytowane w uwaga_kontekstu. Pozycja z kilkoma różnymi sygnaturami dostaje status nie_rozpoznano z polem wiele_sygnatur — rozdziel je. Zły sad lub data POZYCJI są pomijane z polem ostrzezenia (nie 400). Pozycja innego typu (liczba, null) NIE wywraca paczki — staje się stanem nie-rozpoznano.
  • sad — opcjonalny sąd dla CAŁEJ paczki (pozycja-obiekt może go nadpisać): te same reguły co w wersji pojedynczej — enum SUPREME | CONSTITUTIONAL_TRIBUNAL | NATIONAL_APPEAL_CHAMBER | COMMON | ADMINISTRATIVE albo nazwa sądu / miasto. Tekst udający enum („SUPREMEE") albo z operatorami (=; < >) → 400 bad-request.
  • limit — domyślnie 3, przycinany do 1–20. Dotyczy wyłącznie listy orzeczeń w pojedynczej pozycji — autorytatywna liczba trafień jest w polu n, nie w długości tablicy.
  • nagłówki — Content-Type: application/json jest wymagany (inaczej 415 unsupported-media-type). Ciało do 64 kB — 100 sygnatur to około 3 kB, więc ten sufit odcina wyłącznie żądania, które i tak nie mieszczą się w kontrakcie.

Kształt odpowiedzi

{
  "sad": <str|null>,
  "zakres": <str>,            // okno korpusu zdaniem (SAOS + UZP + TK + wybór NSA/WSA + SN z repozytorium2.sn.pl) — raz na paczkę
  "wersja_danych": { "korpus": <str>, "parser_sygnatur": <int>,
                     "zrodlo": <str>, "wygenerowano": <iso8601> },
  "pozycje": <int>,           // ile pozycji miało wejście
  "unikalne": <int>,          // ile RÓŻNYCH sygnatur naprawdę odpytaliśmy
  "kwota": { "endpoint": "weryfikuj-sygnatury",
             "jednostki": <int>,   // ile jednostek pobrało TO żądanie
             "pozostalo": <int>, "zasada": <str> },
  "podsumowanie": { "znaleziono": <int>, "niejednoznaczne": <int>,
                    "inny_sad": <int>, "cytowana": <int>, "brak": <int>,
                    "poza_zakresem": <int>, "nie_rozpoznano": <int>,
                    // legacy (stan):
                    "brak-w-tym-sadzie": <int>, "brak-w-korpusie": <int>,
                    "nie-rozpoznano": <int> },
  "podsumowanie_status": { "znaleziono": <int>, "niejednoznaczne": <int>, "inny_sad": <int>,
                           "cytowana": <int>, "brak": <int>, "poza_zakresem": <int>,
                           "nie_rozpoznano": <int> },
  "limit": <int>,
  "wyniki": [ {              // wyniki[i] ↔ sygnatury[i], zawsze
      "zapytanie": <str>, "sad": <str|null>,
      "stan": "znaleziono" | "niejednoznaczne" | "brak-w-tym-sadzie"
              | "brak-w-korpusie" | "nie-rozpoznano",
      "rozpoznano": <bool>, "istnieje": <bool|null>,
      "status": <str>, "werdykt": <str>, // jak w wersji pojedynczej
      "w_podanym_sadzie": <bool|null>, "n_cytowan": <int>, "n_sadow": <int>,
      "n_sadow_cytujacych": <int>, "uwaga": <str|null>, "data_zgodna": <bool|null>,
      "data_podana": <str>,             // tylko przy poprawnej dacie pozycji
      "sprawdzono": <str|null>, "sady": [ { … } ],
      "wiele_sygnatur": [<str>],        // tylko gdy pozycja ma kilka sygnatur
      "ostrzezenia": [<str>],           // tylko gdy sad/data pozycji pominięto albo pozycję przycięto do 1000 znaków
      "uwaga_kontekstu": <str>,         // tylko gdy tekst pozycji podaje sąd/datę: cytat obok naszych danych
      "rozbior": { … } | null,          // null przy "nie-rozpoznano"
      "w_zakresie": <bool|null>, "n": <int>,
      "w_innym_sadzie": <bool>,
      "orzeczenia": [ { … } ],
      "wskazowka": <str>                // tylko przy "nie-rozpoznano"
  } ]
}

// nagłówki odpowiedzi: X-RateLimit-* oraz
// X-Batch-Cost: <ile jednostek pobrała ta paczka>

Co znaczą pola

wynikiKOLEJNOŚĆ JEST KONTRAKTEM: wyniki[i] odpowiada sygnatury[i], jeden do jednego — także dla pozycji powtórzonych i nierozpoznanych. Nie odsiewamy duplikatów, nie sortujemy, nie zwijamy pustych, bo kolejność jest jedynym sposobem, w jaki przypiszesz wynik do swojego cytatu.
stanten sam pięciowartościowy słownik co w wersji pojedynczej i nie wolno go rozszerzać: znaleziono | niejednoznaczne | brak-w-tym-sadzie | brak-w-korpusie | nie-rozpoznano. Znaczenia — patrz karta „Weryfikacja sygnatury" wyżej.
pozycje / unikalnepozycje to długość Twojego wejścia; unikalne to ile RÓŻNYCH sygnatur naprawdę odpytaliśmy. Deduplikacja oszczędza nasze sondy do bazy — nie oszczędza Twojej kwoty i pole kwota.zasada mówi to wprost.
kwota.jednostki / zasadaile jednostek dobowego licznika pobrało to żądanie i według jakiej zasady. Ta sama liczba jedzie w nagłówku X-Batch-Cost, także przy odmowie 429.
podsumowanie_statusliczniki po status — to czytaj: brak = liczba mocnych sygnałów zmyślenia (tylko TK / KIO), cytowana = istnieją, poza_zakresem = nie wiemy. Klucze status są też w podsumowanie obok starych kluczy stan.
podsumowanieliczniki stanów dla całej paczki — hit rate przebiegu ewaluacji na jeden rzut oka, bez przechodzenia po wynikach.
podsumowanie.poza_zakresemile pozycji ma status poza_zakresem, czyli takich, o których nietrafienie NIC NIE MÓWI (nie wiemy, czy istnieją). brak-w-korpusie = cytowana + brak + poza_zakresem — nie licz z niego zmyśleń.

KWOTA: jedna jednostka za KAŻDĄ POZYCJĘ WEJŚCIA, bez rabatu za hurt. Paczka 100 pozycji kosztuje dokładnie tyle, co 100 osobnych GET-ów na /v1/weryfikuj/sygnatura — liczymy też pozycje powtórzone i nierozpoznane. Gdyby paczka kosztowała jedną jednostkę, byłaby dziurą w liczniku, na którym stoi cała warstwa płatna. Ile naprawdę pobrano, mówi blok kwota i nagłówek X-Batch-Cost; policz to w swoim budżecie ZANIM wyślesz 100 pozycji.

Sufit paczki to 100 pozycji. Powyżej odpowiadamy 413 batch-too-large z nagłówkiem X-Max-Batch: 100 — 413, a nie 400, bo to nie jest zły kontrakt, tylko za duża porcja poprawnego: podziel i powtórz, nie poprawiaj kształtu żądania. Sufit wynika z kosztu meteringu (jedna jednostka to osobne wywołanie licznika), a nie z kosztu sond do bazy.

Błąd jednej pozycji nie jest błędem paczki. Śmieć wśród stu sygnatur dostaje stan nie-rozpoznano (istnieje: null) i paczka leci dalej, ze statusem 200. Status 4xx zostaje wyłącznie dla błędów CAŁEGO żądania — klient, który ponawia 4xx jak błąd transportu, nie może dostać 4xx dlatego, że model zmyślił jeden cytat.

Błędy całego żądania, wszystkie sprawdzane ZANIM cokolwiek obciąży kwotę: 415 unsupported-media-type (brak Content-Type: application/json), 413 payload-too-large (ciało ponad sufit; nagłówek X-Max-Body-Bytes — mierzymy to, co przyszło, bo Content-Length bywa nieobecny albo kłamie), 400 bad-json (ciała nie da się sparsować), 400 bad-request (pusta tablica albo nieznany sad), 413 batch-too-large (za dużo pozycji). Gdy paczka nie mieści się w dziennym liczniku, odmawiamy 429 PRZED naliczeniem reszty, a X-Batch-Cost podaje, ile by kosztowała.

„Brak w korpusie" znaczy „nie ma tego W NASZYM korpusie", nigdy „to orzeczenie nie istnieje". Korpus pochodzi z: SAOS (saos.org.pl) + UZP/KIO (orzeczenia.uzp.gov.pl) + Trybunał Konstytucyjny (trybunal.gov.pl) + wybór NSA/WSA z CBOSA (orzeczenia.nsa.gov.pl, za zbiorem JuDDGES/pl-nsa, CC BY 4.0) + Sąd Najwyższy (repozytorium2.sn.pl, orzeczenia od 23.06.2016; dane przetworzone przez Prawnet) + ELI Sejm RP (akty); orzeczeń SN i sądów powszechnych nie ma w nim w komplecie (SAOS publikuje tylko część orzeczeń sądów powszechnych, a repozytorium SN nie obejmuje np. zarządzeń) — dlatego koperta niesie zakres, a każda pozycja własny status: tylko brak (TK, KIO) jest mocnym sygnałem zmyślenia; cytowana = istnieje; poza_zakresem = nie wiemy.

Kto kogo pozwał i jak to się skończyło

wymaga planu prostabilna

GET /v1/statystyki/rozstrzygniecia

Wyniki wyroków I instancji w trzech kategoriach sporów (kredyty walutowe, klauzule konsumenckie, szkoda osobowa), z podziałem na kierunek sporu: osoba pozywa firmę albo firma pozywa osobę. Te same liczby co na /jak-orzekaja-sady — strona i API czytają jedną zatwierdzoną migawkę.

Parametry

  • kategoria — kredyt_walutowy | klauzule_konsumenckie | szkoda_osobowa; inna wartość → 400. Bez parametru: wszystkie.
  • kierunek — pozwy_osob (osoba pozywa firmę) | pozwy_firm (firma pozywa osobę — tu oddalenie to wygrana osoby); inna wartość → 400.
  • sad — pełna nazwa sądu, porównywana dokładnie (np. „Sąd Okręgowy w Warszawie”), do 120 znaków; filtruje tablicę sady.

Kształt odpowiedzi

{
  "zmierzono": <iso8601>,
  "metoda": { "mierzy": <str>, "nie_mierzy": <str>, "kierunki": { … }, "strony": <str>,
              "instancja": <str>, "pewnosc": <str>, "min_probka_sadu": <int>,
              "bez_sedziow": <str>, "wersja": <str> },
  "dane": [ {
      "kategoria": <str>, "kierunek": "pozwy_osob" | "pozwy_firm",
      "ogolem": { "n": <int>, "uwzgl": <int>, "czesc": <int>, "oddal": <int> },
      "sady": [ { "sad": <str>, "n": <int>, "uwzgl": <int>, "czesc": <int>, "oddal": <int> } ],
      "lata": [ { "rok": <int>, "n": <int>, "uwzgl": <int>, "czesc": <int>, "oddal": <int> } ],
      "url": <str|null>
  } ]
}

Co znaczą pola

ogolemliczby wyroków: uwzgl = powództwo uwzględnione w całości, czesc = w części, oddal = oddalone. Liczby, nie odsetki — odsetek policz sam z n.
sadyten sam podział dla pojedynczych sądów, tylko od min_probka_sadu wyroków.
metodajedzie w KAŻDEJ odpowiedzi: co liczba mierzy i czego nie mierzy.

To NIE jest szansa wygrania sprawy: sądy publikują wybrane wyroki, a ugody, cofnięcia i umorzenia nie są liczone.

Strony rozpoznajemy regułami z sentencji (inicjały = osoba, forma prawna = firma); nazw stron nie przechowujemy. Statystyk dla sędziów nie publikujemy.

Plan płatny (jak /v1/statystyki/czas). Brak zatwierdzonej migawki → 503 api-not-ready z Retry-After.

Liczby wierszy w tej sekcji zmierzono 2026-11-16 zapytaniem count=exact i podajemy je jako stan na ten dzień — rosną wraz z bazą.

Serwer MCP

Te same dane jako narzędzia dla agentów AI

Serwer MCP (Model Context Protocol, transport Streamable HTTP) udostępnia dane jako 7 narzędzi, które asystent AI — Claude.ai, Claude Code albo własny agent — wywołuje sam, bez pisania integracji. Bez klucza: 200 wywołań narzędzi dziennie i 30 na minutę na adres IP (odmowa limitu, nieznane narzędzie i argumenty odrzucone przez schemat narzędzia — zły typ, enum, nadmiarowe pole, za długi tekst — nie zużywają limitu; wywołanie, które przeszło schemat, jest policzone także wtedy, gdy narzędzie odpowie isError: zle_parametry albo wynikiem ze status: nie_znaleziono (brak takiego aktu lub artykułu); klienci hostowani, np. konektory Claude.ai, dzielą adresy IP — do stałej pracy użyj klucza). Z kluczem z panelu: limit planu klucza, ten sam licznik co REST API. Narzędzia nie wymagają planu pro.

# adres serwera (POST, JSON-RPC 2.0; GET zwraca manifest z listą narzędzi)
https://api.prawnet.pl/mcp
# (równoważnie: https://prawnet.pl/api/mcp — do integracji serwerowych używaj api.prawnet.pl)

# opcjonalnie — wywołania liczone na Twoim kluczu zamiast limitu IP
Authorization: Bearer pk_live_TWOJ_KLUCZ
# Claude Code (CLI)
claude mcp add --transport http prawnet https://api.prawnet.pl/mcp --header "Authorization: Bearer pk_live_TWOJ_KLUCZ"

# Claude Code — plik .mcp.json w projekcie
{ "mcpServers": { "prawnet": { "type": "http", "url": "https://api.prawnet.pl/mcp",
    "headers": { "Authorization": "Bearer pk_live_TWOJ_KLUCZ" } } } }

# Claude Desktop — claude_desktop_config.json (przez mcp-remote; działa też na Windows)
{ "mcpServers": { "prawnet": { "command": "npx",
    "args": ["-y", "mcp-remote", "https://api.prawnet.pl/mcp", "--header", "Authorization:${AUTH_HEADER}"],
    "env": { "AUTH_HEADER": "Bearer pk_live_TWOJ_KLUCZ" } } } }

# Claude.ai / Claude Desktop — konektor niestandardowy: sam adres https://api.prawnet.pl/mcp (limit anonimowy)

Platformy zgodne z OpenAI (Chat Completions, vLLM): manifest GET https://api.prawnet.pl/mcp ma pole openai_strict.tools z definicjami funkcji (strict: true, opisy ≤ 1024 znaków). Model zwraca tool_calls — każde wykonaj jako MCP tools/call (POST na ten sam adres, params.name i params.arguments) i oddaj wynik modelowi jako wiadomość role "tool". Wywołanie bez id to notyfikacja JSON-RPC: nie jest wykonywana ani liczona.

znajdz_orzeczenie

Orzeczenie po sygnaturze w dowolnej pisowni: kanoniczny adres, sąd, data, podstawy prawne i gotowy cytat.

sprawdz_sygnature

Czy orzeczenie o tej sygnaturze jest w rejestrze — do sprawdzenia cytatu, zanim model go poda.

orzeczenia_do_przepisu

Orzeczenia powołujące dany artykuł, od najnowszych, z liczbą wg rodzaju sądu. Orzeczenie z datą sprzed wejścia artykułu w życie ma przed_wejsciem_przepisu: true.

wiodace_orzeczenia

Kilka orzeczeń o najwyższym autorytecie cytowaniowym spośród powołujących artykuł — to samo co REST …/wiodace (z losem i poziomem autorytetu).

przepis_w_liczbach

Statystyka cytowań artykułu: podział wg sądu, krzywa roczna, przepisy powoływane razem z nim.

tresc_przepisu

Tekst artykułu z tekstu ujednoliconego Kancelarii Sejmu (rejestr ELI; bez mocy urzędowej — urzędowy jest tekst jednolity w Dz.U.) z datą stanu prawnego; paragraf rozporządzenia („§ 2”) z najnowszego tekstu jednolitego ogłoszonego obwieszczeniem, jaki mamy. Mówi też, czy akt obowiązuje (akt_obowiazuje, uchylony_od) i czy tekst jest pierwotny (tekst_pierwotny_zmieniany). Z polem data (RRRR-MM-DD): brzmienie na ten dzień (brzmienie_na_dzien, przybliżone — ten sam rdzeń co REST …/brzmienie) dla 10 kodeksów; dla innych aktów tekst aktualny z jawną uwagą, że historii nie mamy. Akty z lat 2025–2026: tekst tylko wtedy, gdy Kancelaria Sejmu opublikowała tekst ujednolicony albo (rozporządzenia) obwieszczenie o tekście jednolitym — inaczej odsyłamy do PDF.

ile_zasadzaja

Rozkład kwot zasądzanych za zadośćuczynienie i odszkodowanie: liczebność, kwartyle, mediana.

Każda odpowiedź narzędzia niesie stały link do źródła na prawnet.pl. znajdz_orzeczenie zwraca też krótką tezę: dla TK i SN do połowy 2016 r. z SAOS, w pozostałych przypadkach często streszczenie wygenerowane przez AI — oznaczone polem teza_zrodlo; to materiał pomocniczy, nie treść orzeczenia. Odpowiedzi 401/429 niosą id żądania JSON-RPC, a każda odpowiedź z wywołaniem narzędzia — X-RateLimit-Limit/Remaining/Reset. Konektor Claude (adresy wychodzące Anthropic) po przekroczeniu limitu dostaje zamiast 429 zwykły wynik narzędzia ze status: limit i reset_utc (HTTP 200, te same nagłówki). Każde narzędzie deklaruje outputSchema; serwer ma też prompty (prompts/list): audyt_cytatow, orzecznictwo_do_przepisu, ile_zasadza_sad. Warstwa licencjonowana REST (autorytet, rozstrzygnięcia per orzeczenie, weryfikacja hurtowa, czas trwania) jest dostępna przez REST API powyżej; brzmienie na dzień i orzeczenia wiodące mają też narzędzia MCP.

Limity i błędy

Plany, nagłówki, kody

Limit jest dzienny (doba UTC), liczony osobno na każdy klucz. Stan limitu odczytasz z nagłówków każdej odpowiedzi. Plan decyduje o dwóch rzeczach naraz: ile zapytań dziennie i do których ścieżek. Jedno wywołanie to jedna jednostka licznika — z jednym wyjątkiem: weryfikacja hurtowa pobiera jednostkę za KAŻDĄ pozycję paczki, bez rabatu za hurt. Jednostka schodzi przy bramie, po walidacji parametrów: 400, 401, 403, 413, 415 i 429 nie kosztują nic, ale odpowiedź wydana już PO bramie jest policzona także wtedy, gdy jest odmową — 404 not-found (nieznane id), 422 nie_rozpoznano z /v1/cytuj, 502 i 503; w REST status nie_rozpoznano z /v1/weryfikuj to zwykła odpowiedź 200 i kosztuje jak każda. Nagłówki X-RateLimit-* przy takiej odpowiedzi pokazują już nowy stan.

Plany

  • Free — 1000 zapytań dziennie na klucz; warstwa darmowa w całości; start bez rozmowy z nami. Każdy klucz wygenerowany w panelu powstaje właśnie w tym planie.
  • Pro — 50 000 zapytań dziennie na klucz ORAZ dostęp do warstwy licencjonowanej. Nie da się go włączyć samodzielnie — umawiamy go indywidualnie: info@prawnet.pl
  • Pilot — warstwa licencjonowana na czas testu, nadawana ręcznie partnerom. Limit dzienny i termin klucza pilotażowego ustalamy w porozumieniu z partnerem; faktyczny limit Twojego klucza podaje nagłówek X-RateLimit-Limit, a datę wygaśnięcia — nagłówek X-Key-Expires na każdej odpowiedzi. Po terminie REST odpowiada 403 key-expired. Innych planów nie ma.
  • Nagłówki: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (epoch, północ UTC). Weryfikacja hurtowa dokłada X-Batch-Cost — ile jednostek pobrała ta paczka. Klucz z datą wygaśnięcia dostaje na każdej odpowiedzi X-Key-Expires (ISO 8601).
  • Poza limitem dziennym działa próg awaryjny na adres IP (429 z nagłówkiem Retry-After): 60 wywołań/min bez klucza (dotyczy jedynej trasy anonimowej, /v1/cytuj), 3 000/min z kluczem — klient z kluczem jest w praktyce ograniczany wyłącznie limitem dziennym swojego planu. Anonimowa odpowiedź /v1/cytuj niesie X-RateLimit-Limit: 60 i X-RateLimit-Policy: 60;w=60 (na adres IP, na minutę); bez licznika Remaining, bo ta odpowiedź jest cache’owana publicznie przez CDN. Retry-After przy wyczerpanym limicie dziennym to liczba sekund do północy UTC.
  • Beta: specyfikacja OpenAPI 3.1 (https://api.prawnet.pl/v1/openapi.json) opisuje pola, typy, pola wymagane i enumy każdej odpowiedzi. Pola mogą dochodzić; żadne nie zniknie bez zmiany wersji. Każdy błąd ma pole error (kod) i detail (zdanie po angielsku); 403 plan-required nie zużywa limitu, 404 i 422 po bramie — tak (patrz „Limity”). Każda odpowiedź z danymi niesie wersja_danych (źródło i zastrzeżenie, że to nie porada prawna).

Kody błędów

Ciało błędu ma zawsze ten sam kształt: {"error":"<kod>"} — rozgałęziaj się po kodzie tekstowym, nie po samym statusie HTTP. Niektóre kody niosą pola dodatkowe: 400 bad-request — {"error":"bad-request","param":"sad","detail":"…"}; 403 key-expired — {"error":"key-expired","expired_at":"<ISO 8601>"}. Nowe pola mogą dochodzić — ignoruj nieznane.

400bad-requestnieprawidłowe parametry ścieżki lub zapytania (a w POST /v1/weryfikuj/sygnatury — pusta tablica sygnatur albo nieprawidłowy sad koperty). Ciało wskazuje winowajcę: param (nazwa parametru, np. "sad", "q", "id", "na") i detail (jedno zdanie, co jest nie tak); param pomijamy, gdy błędu nie da się przypisać jednemu parametrowi. Sprawdzane PRZED bramą — literówka nie kosztuje kwoty.
400bad-date/v1/weryfikuj/sygnatura i /v1/cytuj: parametr data nie jest w formacie RRRR-MM-DD (albo to nie jest prawdziwy dzień). Bez kosztu kwoty; w /v1/weryfikuj/sygnatura dopiero po sprawdzeniu klucza (bez klucza najpierw 401).
400multiple-signatures/v1/weryfikuj/sygnatura i /v1/cytuj: q zawiera kilka różnych sygnatur; odpowiedź niesie ich listę (sygnatury) i werdykt. Sprawdź każdą osobno albo wyślij listę do POST /v1/weryfikuj/sygnatury. Bez kosztu kwoty; w /v1/weryfikuj/sygnatura dopiero po sprawdzeniu klucza (bez klucza najpierw 401).
400bad-jsonwyłącznie POST /v1/weryfikuj/sygnatury: ciała żądania nie da się sparsować jako JSON.
401unauthorizedbrak nagłówka Authorization: Bearer pk_live_… albo nagłówek w złym formacie
403forbiddenklucz nieznany lub dezaktywowany. Pomaga wygenerowanie nowego klucza w panelu.
403key-expiredklucz pilotażowy wygasł (ciało: expired_at; nagłówek X-Key-Expires z datą wygaśnięcia). Napisz do nas: info@prawnet.pl — nowy darmowy klucz z panelu NIE otworzy warstwy płatnej.
403plan-requiredklucz jest poprawny, ale plan jest za niski dla tej ścieżki (warstwa licencjonowana). Rotacja klucza NIC tu nie da — potrzebny jest dostęp.
404not-foundzasób nie istnieje (np. nie ma orzeczenia o tym id). Uwaga: „nie mamy etykiety / punktacji dla tego orzeczenia" to 200, nie 404. Nieznana ścieżka pod /v1 (literówka w adresie) to też 404 w JSON, z linkiem do tej dokumentacji. Bardzo długie adresy (kilka tys. znaków) odrzuca już router platformy, zanim dotrą do API.
405method-not-allowedzła metoda HTTP na istniejącej ścieżce (np. POST na trasie GET); nagłówek Allow podaje dozwolone metody.
413batch-too-largewyłącznie POST /v1/weryfikuj/sygnatury: paczka ponad 100 pozycji. Nagłówek X-Max-Batch podaje sufit. To nie jest zły kontrakt, tylko za duża porcja poprawnego — podziel i powtórz.
413payload-too-largewyłącznie POST /v1/weryfikuj/sygnatury: ciało żądania ponad 64 kB (nagłówek X-Max-Body-Bytes). Mierzymy to, co przyszło — Content-Length bywa nieobecny albo kłamie.
415unsupported-media-typewyłącznie POST /v1/weryfikuj/sygnatury: brak nagłówka Content-Type: application/json.
422nie_rozpoznanowyłącznie /v1/cytuj: ciągu nie da się rozebrać na sygnaturę (ciało: status nie_rozpoznano, istnieje null, werdykt). Na ścieżce /v1/weryfikuj/sygnatura i w MCP ten sam przypadek to odpowiedź 200 ze status nie_rozpoznano i tym samym werdyktem.
429rate-limitedprzekroczony dzienny limit planu (nagłówki X-RateLimit-*) albo próg awaryjny na adres IP — patrz nagłówek Retry-After. Przy paczce odmawiamy, zanim naliczymy resztę pozycji, a nagłówek X-Batch-Cost podaje, ile by kosztowała.
502dbchwilowy błąd bazy — ponów zapytanie
503api-not-readyAPI chwilowo niedostępne albo zużycia nie da się zmierzyć. Zapytania, którego nie da się rozliczyć, nie obsługujemy — świadomie zamykamy się, zamiast dawać przejazd za darmo.

Dwa różne 403 — i tylko jeden z nich da się naprawić rotacją klucza

403 forbidden znaczy „tego klucza nie znamy albo został wyłączony" — wygeneruj nowy w panelu. 403 plan-required znaczy coś przeciwnego: klucz jest w porządku i został rozpoznany, tylko jego plan nie obejmuje tej ścieżki — wtedy pomaga wyłącznie podniesienie planu, a nowy klucz da dokładnie ten sam błąd. Trzeci przypadek, 403 key-expired, dotyczy kluczy pilotażowych po terminie: nowy klucz z panelu też nie pomoże (będzie w planie free) — napisz do nas. Rozdzieliliśmy te kody właśnie po to, żeby klient mógł je odróżnić: klient, który tego nie umie, ponawia w nieskończoność.

Źródło orzeczeń i aktów: SAOS (saos.org.pl) + UZP/KIO (orzeczenia.uzp.gov.pl) + Trybunał Konstytucyjny (trybunal.gov.pl) + wybór NSA/WSA z CBOSA (orzeczenia.nsa.gov.pl, za zbiorem JuDDGES/pl-nsa, CC BY 4.0) + Sąd Najwyższy (repozytorium2.sn.pl, orzeczenia od 23.06.2016; dane przetworzone przez Prawnet) + ELI Sejm RP (akty) — orzeczenia NSA/WSA to wybór z CBOSA (orzeczenia.nsa.gov.pl) za zbiorem JuDDGES/pl-nsa na licencji CC BY 4.0, orzeczenia SN po połowie 2016 r. pochodzą z repozytorium Sądu Najwyższego (repozytorium2.sn.pl; Sąd Najwyższy nie odpowiada za ich przetworzenie przez Prawnet), a teksty jednolite aktów, z których pochodzi brzmienie przepisu na dzień, pochodzą z publicznego API ELI Sejmu (api.sejm.gov.pl/eli). Opracowaniem Prawnet jest to, co z nich zbudowaliśmy: graf cytowań, indeks sygnatur, sieć cytowań między orzeczeniami, etykiety rozstrzygnięć, autorytet i wersje przepisów. Użycie API podlega tym samym zasadom co pakiet Prawnet Dane: w zakresie, w jakim przysługują nam prawa do bazy danych (ustawa o ochronie baz danych) i do jej opracowania, zastrzegamy eksplorację tekstów i danych (art. 26³ ust. 1 pr. aut.) — trenowanie lub dostrajanie modeli AI/ML na danych z API wymaga umowy, także na warstwie darmowej. Zastrzeżenie nie obejmuje samych orzeczeń i aktów prawnych (art. 4 pr. aut.) ani eksploracji do celów badań naukowych prowadzonej przez uprawnione instytucje (art. 26² pr. aut.). Odpowiedzi API i MCP nie są poradą prawną; moc wiążącą mają teksty ogłoszone w Dzienniku Ustaw i orzeczenia w źródłach.