Pelnora PrawoOtwórz aplikację

Dla agentów AI i programistów

Przepisy i orzeczenia z bazy Pelnory można czytać także programem: przez serwer MCP i przez API REST. Dostęp jest otwarty i służy wyłącznie do odczytu.

Zasady dostępu i limity mogą się zmienić. Aktualne są zawsze na tej stronie.

Serwer MCP

Adres
https://corpus.pelnora.app/mcp
Transport
Streamable HTTP, metoda POST, odpowiedzi w formacie JSON (bez SSE)
Protokół
2026-07-28 oraz 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05 i 2024-10-07
Dostęp
tylko odczyt, klucz nie jest wymagany

Serwer jest bezstanowy. Jedno żądanie POST to jedno wywołanie: wsady JSON-RPC nie są obsługiwane, a treść żądania może mieć najwyżej 64 KiB. Subskrypcje nie są obsługiwane, lista narzędzi jest stała.

Żądanie z nagłówkiem Origin spoza listy dozwolonych adresów dostaje odpowiedź 403. Klient bez nagłówka Origin (program, serwer) jest obsługiwany.

Jak dodać serwer w kliencie

  1. W kliencie MCP wybierz dodanie serwera zdalnego (HTTP).
  2. Podaj adres https://corpus.pelnora.app/mcp. Klucz ani logowanie nie są wymagane.
  3. Po połączeniu klient pokaże osiem narzędzi opisanych niżej.

Narzędzia

Wynik narzędzia to JSON API: te same stany, polityka publikacji i citation. Każdy wynik bez błędu niesie pola state, asOf, license i citation (gotowe zdanie do cytowania z atrybucją „Pelnora, pelnora.app”). Wynik z błędem (isError) niesie treść błędu, na przykład pole error albo listę nearest. Wyjątek: get_provision podaje treść w body i oznaczenie w unitLabel, bez pola text.

list_acts
Szuka aktów z tekstem w bazie Pelnory (bramki G1–G3) po fragmencie tytułu albo ELI.
get_act
Stan aktu: bramka zaufania, stan tekstu na dzień (state), wersja, pochodzenie (TJ / rekonstrukcja, nowele), tytuł, citation.
get_provision
Przepis na dzień ze stanem i zdaniem do cytowania: treść w body (bez oznaczenia), oznaczenie w unitLabel („art. 52 § 1”).
rulings_for_provision
Wyłącznie ORZECZENIA (documentKind: ruling) powołujące akt albo przepis (z jednostkami podrzędnymi), najnowsze pierwsze.
get_ruling
Dokument po identyfikatorze (np. sn:…, saos:…, cbosa:…): metadane, documentKind (ruling = orzeczenie; legal_question, request, unknown to nie orzeczenia), tekst gdy polityka publikacji pozwala (inaczej textStatus i textNote; textNote przy tekście = uszkodzony fragment u źródła), powołane przepisy, citation.
search_docket
Wszystkie dokumenty pod sygnaturą (dopasowanie dosłowne; gdy go brak, bez rozróżniania wielkości liter, z polem docketMatch: "case-insensitive" i sygnaturą pozycji w brzmieniu źródła; I CZ to SN, I Cz to sąd okręgowy): orzeczenia i np. zagadnienie prawne rozstrzygane pod tą samą sygnaturą.
get_status
Świeżość bazy (asOf.prawo: dzień bazy prawa, czyli ostatni udany przebieg prawa albo dzień ostatniej pełnej publikacji, jeśli późniejszy; ostatnia pełna publikacja prawa, pole fullPublication: OK / STALE po 48 h / UNKNOWN; najnowsze orzeczenie per typ sądu), liczby aktów per bramka i orzeczeń per typ sądu.
get_timeline
Oś czasu aktu: daty (ogłoszenie, wejście w życie, uchylenie, wygaśnięcie), teksty jednolite z datą stanu, wersje tekstu [validFrom, validTo) z pochodzeniem (TJ / rekonstrukcja, nowele zastosowane, flagi „z mocą od” / „stosuje się od”), odcinki zamknięte z liczbą jednostek bez tekstu, nowelizacje z datami wejścia w życie transz.

Przykłady

Każdy przykład podaje argumenty narzędzia, ten sam odczyt przez API REST i skróconą odpowiedź z listą pominiętych pól. Wartości pochodzą z odczytu z 17 listopada 2026 r. i mogą się zmienić.

Przepis na dzień

Art. 385¹ § 1 Kodeksu cywilnego według stanu na 1 listopada 2026 r. Narzędzie get_provision, argumenty:

{"eli":"DU/1964/93","unit":"art. 385^1 § 1","stan":"2026-11-01"}

Ten sam odczyt przez API REST:

GET https://corpus.pelnora.app/prawo/acts/DU-1964-93/unit?path=arti(385%5E1)%2Fpara(1)&stan=2026-11-01

Odpowiedź narzędzia, skrócona. Pominięte pola: lineage, tombstone, gateReason, asOf, provenance, structure, tkNotices, isapUrl, provenanceLabel, pendingVersions, unappliedAmendments, annexesNotCovered, patches, title, sourceUrl, license, pageUrl oraz pola citation poza text.

{
  "path": "arti(385^1)/para(1)",
  "unitLabel": "art. 385¹ § 1",
  "body": "Postanowienia umowy zawieranej z konsumentem nieuzgodnione indywidualnie nie wiążą go, jeżeli kształtują jego prawa i obowiązki w sposób sprzeczny z dobrymi obyczajami, rażąco naruszając jego interesy (niedozwolone postanowienia umowne). Nie dotyczy to postanowień określających główne świadczenia stron, w tym cenę lub wynagrodzenie, jeżeli zostały sformułowane w sposób jednoznaczny.",
  "state": "OK",
  "stan": "2026-11-01",
  "gate": "G2",
  "coveredFrom": "2013-12-13",
  "citation": {
    "text": "Art. 385¹ § 1 Kodeksu cywilnego (t.j. Dz.U. 2026 poz. 795), stan na 1 listopada 2026 r. (Pelnora, pelnora.app, CC BY 4.0)"
  },
  "stateDetails": {
    "knownGaps": [
      {
        "id": "A2",
        "what": "Stan aktu na dzień poprzedzający wejście w życie przepisu, który tekst jednolity zapowiada z późniejszą datą, może już zawierać ten przepis albo jego nowe brzmienie. Dotyczy 1 161 jednostek w 167 aktach (spis z 12.11.2026). Stan na dzień dzisiejszy jest poprawny.",
        "ref": "/status/public"
      }
    ]
  }
}

Pole state podaje stan tekstu na dzień stan. body to treść przepisu bez oznaczenia, unitLabel to oznaczenie. coveredFrom to dzień, od którego baza ma tekst tego aktu. citation.text to gotowe zdanie do cytowania. W dniu odczytu odpowiedź niosła stateDetails.knownGaps (znana luka zakresu). API REST podaje dodatkowo pole text.

Orzeczenia do przepisu

Orzeczenia Sądu Najwyższego powołujące art. 52 § 1 Kodeksu pracy, strona po dwie pozycje. Narzędzie rulings_for_provision, argumenty:

{"eli":"DU/1974/141","unit":"art. 52 § 1","courtType":"SUPREME","limit":2}

Ten sam odczyt przez API REST:

GET https://corpus.pelnora.app/orzeczenia/by-provision?courtType=SUPREME&limit=2&lineage=DU-1974-141&path=arti(52)%2Fpara(1)

Odpowiedź narzędzia, skrócona. Z dwóch pozycji results pokazana jest pierwsza. Pominięte pola odpowiedzi: lineage, provenance, sources, kind, asOf, license, citation. Pominięte pola pozycji: courtType, dateStatus, source, sourceUrl, originalSourceUrl, originalSourceNote, anonymization, matchedPaths, origin, pageUrl oraz pola citation poza text.

{
  "path": "arti(52)/para(1)",
  "returned": 2,
  "limit": 2,
  "truncated": true,
  "results": [
    {
      "id": "sn-wayback:pl_sn_sites_orzecznictwo_orzeczenia3_iii_20pskp_204_24_pdf",
      "courtName": "Sąd Najwyższy",
      "docket": "III PSKP 4/24",
      "judgmentDate": "2024-10-23",
      "documentKind": "ruling",
      "judgmentType": "wyrok",
      "textStatus": "ok",
      "citation": {
        "text": "Wyrok SN z 23 października 2024 r., III PSKP 4/24 (Pelnora, pelnora.app, za: sn.pl, kopia w Internet Archive)"
      },
      "provisionAtJudgmentDate": {
        "tool": "get_provision",
        "arguments": {
          "eli": "DU-1974-141",
          "unit": "art. 52 § 1",
          "stan": "2024-10-23"
        }
      }
    }
  ],
  "knownGaps": [
    {
      "courtType": "SUPREME",
      "scope": "dataset",
      "note": "część pozycji bez tekstu: feed SN dostaje skany, nie tekst"
    }
  ],
  "nextCursor": "WyIyMDI0LTAxLTIzIiwic24td2F5YmFjazpwbF9zbl9zaXRlc19vcnplY3puaWN0d29fb3J6ZWN6ZW5pYTNfaV8yMHBza18yMDEyXzIzX3BkZiJd",
  "otherDocuments": {
    "total": 0,
    "byKind": {}
  },
  "state": "OK"
}

Lista obejmuje wyłącznie orzeczenia powiązane z tym przepisem w bazie Pelnory, w kolejności od najnowszej daty orzeczenia. Pierwsza pozycja to najnowsze orzeczenie z takim powiązaniem w bazie, a nie najnowsze orzeczenie sądu. Każda pozycja ma textStatus i citation. nextCursor prowadzi do następnej strony. provisionAtJudgmentDate to wywołanie get_provision z dniem orzeczenia (brzmienie przepisu w dniu orzeczenia); to pole dodaje tylko serwer MCP, API REST go nie podaje. otherDocuments liczy zagadnienia prawne, wnioski o podjęcie uchwały i dokumenty nieustalonego rodzaju. knownGaps podaje znane luki zakresu.

Wyszukiwanie po sygnaturze

Dokumenty pod sygnaturą III CZP 38/24. Narzędzie search_docket, argumenty:

{"docket":"III CZP 38/24"}

Ten sam odczyt przez API REST:

GET https://corpus.pelnora.app/orzeczenia/by-docket?docket=III%20CZP%2038%2F24

Odpowiedź narzędzia, skrócona. Pominięte pola odpowiedzi: returned, limit, truncated, sources, asOf, license, citation. Pominięte pola pozycji: courtType, courtCode, dateStatus, source, sourceUrl, originalSourceUrl, originalSourceNote, anonymization, citation.

{
  "docket": "III CZP 38/24",
  "total": 1,
  "courts": [
    {
      "courtType": "SUPREME",
      "n": 1
    }
  ],
  "results": [
    {
      "id": "sn-wayback:pl_sn_sites_orzecznictwo_orzeczenia3_iii_20czp_2038_24_pdf",
      "courtName": "Sąd Najwyższy",
      "docket": "III CZP 38/24",
      "judgmentDate": "2025-04-08",
      "documentKind": "ruling",
      "judgmentType": "postanowienie",
      "textStatus": "ok",
      "pageUrl": "https://pelnora.app/orzeczenia/sad-najwyzszy/III_CZP_38/24"
    }
  ],
  "knownGaps": [
    {
      "courtType": "SUPREME",
      "scope": "dataset",
      "note": "część pozycji bez tekstu: feed SN dostaje skany, nie tekst"
    }
  ],
  "state": "OK"
}

Dopasowanie sygnatury jest dosłowne, a gdy go brak, bez rozróżniania wielkości liter (pole docketMatch). Pod sygnaturą mogą być orzeczenia i inne dokumenty, na przykład zagadnienie prawne: rodzaj podaje documentKind (ruling to orzeczenie). courts to podsumowanie według sądu, pageUrl to adres strony orzeczenia.

Zapis przepisu

Akt wskazujesz przez ELI: DU/1964/93 albo DU-1964-93 (Kodeks cywilny). Przepis podajesz tak jak w piśmie, na przykład „art. 52 § 1 pkt 3 lit. a”, albo ścieżką arti(52)/para(1).

Indeks górny numeru możesz zapisać na trzy sposoby: art. 385^1, art. 385(1) albo art. 385¹. Każdy z nich oznacza ten sam przepis, ścieżka arti(385^1).

Stan prawny na dzień

Parametr stan to dzień w zapisie RRRR-MM-DD. W get_act i get_provision bez stan: dziś w strefie Europe/Warsaw. W list_acts, get_status i rulings_for_provision bez stan: bez filtra dnia.

Wersja tekstu obowiązuje w przedziale półotwartym [validFrom, validTo): dzień validTo należy już do następnej wersji. Dzień przed pierwszą wersją aktu (coveredFrom) daje stan NOT_COVERED bez tekstu, nigdy cichy zamiennik tekstem z innego dnia.

Skutek wsteczny („z mocą od”) i data stosowania („stosuje się od”) nie są modelowane.

Limity

Limity dotyczą API REST i serwera MCP pod adresem corpus.pelnora.app. Liczenie jest przybliżone.

W serwerze MCP limit jest liczony raz na żądanie POST.

Po przekroczeniu limitu odpowiedź ma kod 429 i nagłówki Retry-After: 60 oraz x-corpus-limit-scope (ip, ua albo partner). Limit brzegowy daje odpowiedź 429 Cloudflare (error code: 1015, Retry-After: 10), bez nagłówków x-corpus-*.

Strony pelnora.app/prawo i pelnora.app/orzeczenia mają osobny limit: 120 zapytań na minutę na czytelnika.

Stany odpowiedzi

Każda odpowiedź API niesie nagłówek x-corpus-state, a odpowiedzi z danymi także pole state. Wynik narzędzia MCP podaje stan w _meta.state.

Stany NOT_COVERED, UNAPPLIED_SINCE, REPEALED, UNKNOWN, WORDING_CONFLICT i TEXT_UNCERTAIN: nie cytuj tekstu jako obowiązującego.

Tekst aktu i przepisu na dzień

OK
Tekst obowiązujący na dzień stan. Cytuj z citation.text.
FUTURE_PENDING
Pytanie o dzień w przyszłości: tekst to brzmienie bieżące bez zmian, które wejdą do tego dnia (lista w stateDetails). Nie cytuj jako brzmienia na ten dzień.
NOT_COVERED
Brak tekstu na dzień, na przykład dzień przed pierwszą wersją aktu w bazie (coveredFrom). Odpowiedź nie zawiera tekstu z innego dnia.
UNAPPLIED_SINCE
Nieuwzględniona nowelizacja: tekst to brzmienie bez tych zmian (lista w stateDetails).
REPEALED
Akt uchylony albo wygasły na ten dzień. Tekst w ostatnim brzmieniu.
WORDING_CONFLICT
Tekst jednolity drukuje kilka brzmień jednostki, a inne niż podawane ma datę, która już minęła, albo daty nie ma w źródłach. Bez tekstu: wszystkie brzmienia są w wordings. Nie wybieraj brzmienia.
TEXT_UNCERTAIN
Tekst podany, ale może być niepełny albo nie tym brzmieniem: tekst jednolity drukuje pod ścieżką przepisu (albo przepisu niższego) kilka brzmień albo w numeracji jednostek niższych brakuje pozycji, albo kontrola ustaliła niezgodność przepisu (lub przepisu niższego) z tekstem jednolitym (textCheck: tekst jednolity i strona). Powody w stateDetails.textUncertain. Nie cytuj jako pewnego brzmienia.
REPEALED_NOT_APPLIED
Przepis uchylony, a zmiana nie jest jeszcze naniesiona w tekście. Bez tekstu; zdanie dla użytkownika w stateDetails.unitMark.notice.
CHANGE_NOT_APPLIED
Przepis zmieniony, a zmiana nie jest jeszcze naniesiona w tekście. Bez tekstu; zdanie dla użytkownika w stateDetails.unitMark.notice.
NOT_YET_IN_FORCE
Przepis przed dniem wejścia w życie. Bez tekstu; zdanie dla użytkownika w stateDetails.unitMark.notice.
NO_TEXT
Akt znany (tytuł, bramka, sourceUrl), ale jego tekstu w bazie Pelnory nie ma: tylko metadane, tekst u źródła.
UNKNOWN
Stan nieustalony: stan na ten dzień nie został odczytany.

Orzeczenia

WITHHELD
Tekst orzeczenia niepublikowany (polityka publikacji): tylko metadane i adres źródła.
CORRECTED
Orzeczenie po korekcie: tekst po korekcie.
WITHDRAWN
Orzeczenie wycofane (kod 410). Nie cytuj.
DUPLICATE_OF
Kopia tego samego dokumentu. Cytuj rekord główny z primaryId.

Każda odpowiedź

NOT_FOUND
Kod 404: brak aktu, jednostki albo orzeczenia.
REJECTED
Odmowa (parametr, token, metoda, format), z kodem w nagłówku: REJECTED; code=400. Powód w polu error.
LIMITED
Kod 429: limit zapytań, z zakresem w nagłówku: LIMITED; scope=ip.
ERROR
Błąd serwera (kod 5xx). Identyfikator requestId w treści.
STALE
Dane przeliczane okresowo (pokrycie orzeczeń) są nieświeże i podane z datą przeliczenia: STALE; computedAt=….

Tekst orzeczenia: pole textStatus

Pole textStatus niesie odczyt orzeczenia (get_ruling) i każda pozycja list orzeczeń. Pozycja listy nie zawiera tekstu: jej textStatus mówi, co poda odczyt orzeczenia, i jest ustalany bez czytania tekstu. Gdy lista podaje ok, odczyt orzeczenia może jeszcze odpowiedzieć not_loaded.

ok
Odczyt orzeczenia podaje tekst w polu text.
withheld
Tekst niepublikowany: polityka źródła albo data graniczna grupy. Tylko metadane i adres źródła.
withdrawn
Orzeczenie wycofane (kod 410) albo tekst usunięty po wycofaniu, którego wpis cofnięto. Nie cytuj.
corrected
Orzeczenie po korekcie: w odczycie orzeczenia pole text to tekst korekty. Gdy pola text nie ma, tekst korekty nie jest dostępny (powód w textNote). Tekstu sprzed korekty nie podajemy.
not_loaded
Tekst jest u źródła, naszej poprawnej kopii nie ma.
missing_at_source
Źródło nie podaje tekstu.
unrecoverable
Tekst utracony i nieodzyskiwalny ze źródła.
flagged
Tekst wstrzymany wpisem w rejestrze wyjątków. Tylko metadane i adres źródła.

Pola obok stanu

API REST i pliki dla modeli

Adres API: https://corpus.pelnora.app, metoda GET. Stan aktu, jednostka, orzeczenie i listy orzeczeń: ten sam URL daje JSON (domyślnie) albo markdown z nagłówkiem YAML (?format=md albo Accept: text/markdown). Pozostałe trasy: JSON.

https://corpus.pelnora.app/llms.txt
Jak pytać, stany i limity.
https://corpus.pelnora.app/llms-full.txt
Indeks aktów z tekstem.
https://corpus.pelnora.app/openapi.json
Opis API (OpenAPI 3.1).
https://corpus.pelnora.app/license
Licencja i atrybucja.
https://corpus.pelnora.app/status/public
Stan bazy Pelnory i lista znanych luk zakresu (knownGaps).

Licencja i atrybucja

Teksty aktów prawnych i orzeczeń sądów są materiałami urzędowymi i nie podlegają prawu autorskiemu (art. 4 ustawy o prawie autorskim i prawach pokrewnych). Pelnora pobiera je z ISAP i ELI (Sejm RP), SAOS, CBOSA (NSA), portalu orzeczeń sądów powszechnych, serwisu Sądu Najwyższego, portalu orzeczeń Trybunału Konstytucyjnego i Urzędu Zamówień Publicznych.

Własne opracowanie Pelnory, czyli teksty aktów z naniesionymi zmianami, powiązania przepisów z orzeczeniami, opisy stanu prawnego i dane o dokumentach, udostępniamy na licencji Creative Commons Uznanie autorstwa 4.0 Międzynarodowe (CC BY 4.0). Korzystając z nich, wskaż źródło: „Pelnora, pelnora.app”.

Część orzeczeń sądów administracyjnych pochodzi ze zbioru JuDDGES/pl-nsa, udostępnionego na licencji CC BY 4.0.

Wiążące są teksty ogłoszone w Dzienniku Ustaw.

Kontakt: kontakt@pelnora.app

Odpowiedzi z danymi niosą pola license i citation. Pełna treść licencji i atrybucje zbiorów źródłowych: https://corpus.pelnora.app/license.

Orzeczenia SN z Web API (source: "sn-api"): Orzeczenia Sądu Najwyższego pochodzą od Sądu Najwyższego i zostały pobrane z serwera repozytorium2.sn.pl za pośrednictwem Web API Sądu Najwyższego. Pelnora przetworzyła te informacje: zmieniła ich format, wyodrębniła metadane, powiązała orzeczenia z przepisami, sklasyfikowała dokumenty i prezentuje fragmenty tekstu w wynikach wyszukiwania. Sąd Najwyższy nie zatwierdza ani nie rekomenduje Pelnory i nie ponosi odpowiedzialności za jej opracowania. Informacje mogły się zmienić po pobraniu; przed wykorzystaniem w działalności profesjonalnej sprawdź orzeczenie u źródła.

Charakter tekstów

Teksty aktów prawnych na tych stronach są nieoficjalne. Moc prawną ma wyłącznie tekst ogłoszony w Dzienniku Ustaw. Dotyczy to także tekstów w odpowiedziach API i serwera MCP.

Teksty orzeczeń pokazujemy w postaci udostępnionej przez źródła, zanonimizowanej przez sądy; zmieniamy wyłącznie układ tekstu (akapity, nagłówki) i usuwamy elementy stron plików PDF (numery i stopki stron, znaczniki redakcyjne). Gdy źródło nie potwierdza anonimizacji, pokazujemy tylko dane orzeczenia i odnośnik do źródła.

Kontakt

kontakt@pelnora.app. Pod tym adresem przyjmujemy zgłoszenia błędów w tekstach oraz wnioski dotyczące danych osobowych w orzeczeniach.

O klucz partnerski napisz na ten sam adres.