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
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
- W kliencie MCP wybierz dodanie serwera zdalnego (HTTP).
- Podaj adres
https://corpus.pelnora.app/mcp. Klucz ani logowanie nie są wymagane. - 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 wunitLabel(„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).
- Zapis bez znaku indeksu,
art. 3851, oznacza artykuł o takim numerze. - Nawias tuż po numerze, bez spacji, to zawsze indeks górny:
art. 22(1)to art. 22¹, nigdy ust. ani §. - Zapis ze spacją przed nawiasem,
art. 385 (1), zwraca błąd. - Zapis niejednoznaczny (bez artykułu, powtórzony rodzaj jednostki, zła kolejność) zwraca błąd z powodem.
- Załączniki i jednostki systematyki (dział, rozdział) zwracają błąd.
- Gdy przepis nie istnieje, odpowiedź zawiera listę najbliższych jednostek (
nearest).
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.
- 120 zapytań na minutę z jednego adresu IP (IPv6: z jednego prefiksu /64).
- 30 zapytań na minutę z adresu IP, gdy żądanie nie ma nagłówka
User-Agent(zamiast 120). - 600 zapytań na minutę na jeden
User-Agent, łącznie ze wszystkich adresów IP. - Z kluczem partnerskim: 600 zapytań na minutę na klucz, zamiast limitów z adresu IP i
User-Agent. Klucz podajesz w nagłówkux-partner-keyalboAuthorization: Bearer, w komunikacji między serwerami, nie w przeglądarce. - Niezależnie od tych limitów brzeg domeny
corpus.pelnora.app: 30 zapytań na 10 sekund z adresu IP. Obowiązuje także partnerów.
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 zcitation.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 wstateDetails.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 poluerror. LIMITED- Kod 429: limit zapytań, z zakresem w nagłówku:
LIMITED; scope=ip. ERROR- Błąd serwera (kod 5xx). Identyfikator
requestIdw 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
textto tekst korekty. Gdy polatextnie ma, tekst korekty nie jest dostępny (powód wtextNote). 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
gate: G1 tekst zweryfikowany torem zaufania, G2 tekst jednolity bez nowelizacji po nim, G3 rekonstrukcja z nierozstrzygniętą rozbieżnością albo nieuwzględnioną nowelizacją (sprawdzajgateReason), G4 metadane bez tekstu.stateDetails.stale(przyOKiFUTURE_PENDING): baza Pelnory może być nieaktualna, bo od ostatniej pełnej aktualizacji minęło ponad 48 h. Przekaż użytkownikowi komunikat z polanote.documentKind:rulingto orzeczenie.legal_question(zagadnienie prawne),request(wniosek o podjęcie uchwały) iunknown(rodzaj nieustalony) nie są orzeczeniami: nie cytuj ich jako wyroku ani uchwały.
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.