Polias Legal API
Court decisions, legislation and EU law from Germany, Austria, Switzerland, the European Union, France, the Netherlands and Spain in one API. Filter by court, level, instance, area of law, date and cited provision, sort by date, and get the full text wherever the licence allows it. Every result names its source and licence.
Offer and prices Same key and same credit as the Search API: €1 per 1,000 requests, 1,000 a month free.
Quick start
Send your key in the header X-API-Key (or Authorization: Bearer …) and search:
curl -H "X-API-Key: pol_YOUR_API_KEY" "https://api.polias.eu/v1/legal?q=K%C3%BCndigung&court=BAG&sort=date"
No key yet? Get one: 1,000 requests a month are free. Keep it on your server, never in code that runs in a browser.
Endpoints
GET /v1/legal
Search court decisions and legislation with all filters below. German alias: /v1/recht.
GET /v1/legal/document?id=…
One document by ECLI, CELEX, ELI or Polias id: metadata and the text where the licence allows it (details).
GET /v1/ki?scope=legal
The AI search restricted to legal sources, with the same filters; built for retrieval in AI applications.
GET /v1/search?result_filter=legal
Legal results as their own block next to web results or news (e.g. result_filter=web,legal). The full set of filters is on /v1/legal.
Parameters
Several values in one parameter mean OR (comma-separated); different parameters are combined with AND. Filters apply before results are picked, so a narrow filter still returns full pages when there are matches.
| Parameter | Values | Example |
|---|---|---|
q | Query, required, up to 200 characters. Case numbers, ECLI and citations work too. | q=Mietminderung Schimmel |
country | de, at, ch, eu, fr, nl, es | country=de,at |
level | eu, national (federal), regional (state, canton, region) | level=regional |
region | ISO 3166-2 code, e.g. DE-NW, DE-BY, CH-ZH; the short form nw works if unique | region=DE-NW |
court | ECLI court code or common abbreviation: DE:BGH / BGH, BAG, EU:C / CJEU, EU:T, CH:BGER / BGer, AT:VFGH, NL:HR, FR:CCASS / Cass, FR:CE, FR:CC. A prefix selects a group, e.g. FR:CAA (all administrative courts of appeal); a court name works too. | court=BGH |
instance | supreme, appeal, first | instance=supreme |
area | civil, criminal, administrative, labour, social, tax, constitutional | area=labour |
type | decision, leading_decision, opinion (Advocate General, Parket), statute, ordinance, treaty, legislation (all norms), eu_act, eu_regulation, eu_directive, eu_decision, parliamentary | type=leading_decision |
from, to | Date as YYYY, YYYY-MM or YYYY-MM-DD; to=2023 means until 31 December 2023 | from=2024-01-01 |
sort | relevance (default), date (newest first among the most relevant matches), date_asc | sort=date |
cites | Decisions citing a provision; several separated by ;. Written as usual in each country: § 536 BGB, Art. 271 OR, article L1234-9 code du travail, art. 7:658 BW, Art. 8 ECHR | cites=§ 280 BGB |
lang | Language of the document for multilingual sources (Switzerland, EU): de, fr, it, en, nl, es. In /v1/ki: legal_lang | lang=fr |
valid_on | Today or later. We hold the versions in force today; an earlier date returns 400 with an explanation instead of mixing versions. | valid_on=2026-12-01 |
facets | 1: counts per court, level, country, type, area, instance and year over the matching candidates (facets_basis says how many) | facets=1 |
count, offset | Results per request 1–10 (default 10); offset 0–40 for the next pages (10 = page 2), each page is one request | count=5 |
German parameter names (land, gericht, art, von, bis …) keep working. Wrong values give 400 with an explanation and cost nothing.
Response
Top level: query, results, filter_documents (documents in the index that match your filters, regardless of the query), facets and facets_basis with facets=1, notice (e.g. when no document matches the filters) and usage.
| Field per result | Meaning |
|---|---|
id | Polias id; works with /legal/document |
title, url | Title and link to the official source |
court, court_code | Court (for legislation: the issuing body) and its ECLI-style code, e.g. DE:BAG |
case_number, date | Case number (for legislation: the abbreviation or section) and date |
country, level, region, instance, area | As in the filters; area is a list |
type, leading | Document type; leading marks leading decisions |
ecli, celex, version | Identifiers where they exist; version for legislation |
headnote | Official headnote where published by the court |
cited_norms | Provisions cited by the decision |
excerpt | Short passage matching the query |
language | Language of the document |
license, notice | Licence and source notice. Please show notice with the result. |
ai_training | erlaubt: the licence allows reuse of the text (official works, CC0, CC BY, Licence Ouverte, EUR-Lex); nur_suche: search only, use title, excerpt and link |
For now each result also carries the same fields with German names (gericht, aktenzeichen, datum …), and the top level carries frage/treffer. Please use the English names.
{
"query": "Kündigung Arbeitsvertrag",
"results": [
{ "id": "de-neuris-KARE600040076", "title": "BAG, Urteil vom 6. September 2012 - 2 AZR 270/11",
"url": "https://…", "court": "BAG", "court_code": "DE:BAG", "case_number": "2 AZR 270/11",
"date": "2012-09-06", "country": "de", "type": "decision", "level": "national",
"instance": "supreme", "area": ["labour"], "language": "de",
"cited_norms": ["§ 626 Abs 1 BGB", "§ 1 Abs 2 S 1 Alt 2 KSchG"], "excerpt": "…",
"license": "…", "notice": "Quelle: Rechtsinformationsportal des Bundes, rechtsinformationen.bund.de",
"ai_training": "erlaubt" }
],
"filter_documents": 7314,
"usage": { "today": 12, "month": 340 }
}
Full text: /legal/document
curl -H "X-API-Key: pol_YOUR_API_KEY" "https://api.polias.eu/v1/legal/document?id=ECLI:NL:HR:2026:1347"
id: ECLI, CELEX, ELI (full or short, e.g.eli/cc/2012/268) or the Poliasid.- The answer has
documentswith the fields above plustext, where the licence allows reuse (ai_training: erlaubt). Otherwise you get the short excerpt (up to 160 characters) and the link (today: Spanish legislation from the BOE). text_completesays honestly whethertextis the whole document. For long judgments and acts we currently hold a shortened text: thentext_completeisfalse,text_noteexplains it, andurlleads to the complete official version.- One found document counts as one request;
404(not found) is free.
Examples
Germany: labour court decisions on dismissal, newest first
curl -H "X-API-Key: pol_YOUR_API_KEY" "https://api.polias.eu/v1/legal?q=K%C3%BCndigung+Arbeitsvertrag&court=BAG&sort=date"
France: Cour de cassation, labour chamber, on serious misconduct
curl -H "X-API-Key: pol_YOUR_API_KEY" "https://api.polias.eu/v1/legal?q=licenciement+faute+grave&court=Cass&area=labour"
EU: Court of Justice on data protection access rights since 2023
curl -H "X-API-Key: pol_YOUR_API_KEY" "https://api.polias.eu/v1/legal?q=data+protection+right+of+access&court=CJEU&from=2023&lang=en"
Switzerland: Federal Supreme Court decisions citing Art. 271 OR (tenancy)
curl -H "X-API-Key: pol_YOUR_API_KEY" "https://api.polias.eu/v1/legal?q=Mietvertrag+K%C3%BCndigung&cites=Art.+271+OR&country=ch"
Python: search and print court, case number and source notice
import json, os, urllib.parse, urllib.request
params = {"q": "Mietminderung Schimmel", "court": "BGH", "sort": "date", "count": 5}
request = urllib.request.Request("https://api.polias.eu/v1/legal?" + urllib.parse.urlencode(params),
headers={"X-API-Key": os.environ["POLIAS_API_KEY"]})
for hit in json.load(urllib.request.urlopen(request, timeout=15))["results"]:
print(hit["court"], hit["case_number"], hit["date"], hit["url"])
print(" ", hit.get("headnote") or hit.get("excerpt", ""))
print(" ", hit["notice"])
More ready-made code, example projects and a builder: api.polias.eu/examples.
Coverage
Polias Legal draws only on official, freely usable sources. Each result names its source and licence.
Germany
Federal courts (BVerfG, BGH, BVerwG, BFH, BAG, BSG, BPatG) via the federal legal information portal, decisions from North Rhine-Westphalia and Bavaria, federal statutes and ordinances section by section.Austria
Constitutional Court (VfGH) and Supreme Administrative Court (VwGH).Switzerland
Federal Supreme Court with its leading decisions, Federal Administrative Court and Federal Criminal Court, in German, French and Italian.European Union
Court of Justice and General Court with Advocate General opinions, regulations, directives and decisions from EUR-Lex.France
Cour de cassation, Conseil d'État, Conseil constitutionnel, administrative courts of appeal and courts of appeal, and the codes from Légifrance (DILA, Licence Ouverte).Netherlands
Hoge Raad with the opinions of the Parket, Raad van State, Centrale Raad van Beroep, College van Beroep voor het bedrijfsleven, the courts of appeal and district courts (rechtspraak.nl, CC0).Spain
National legislation from the BOE, for search (title, excerpt, link).Decisions are delivered as the courts publish them (anonymised or pseudonymised). It is not allowed to use the results to re-identify people; see no. 4 of the terms of the Search API. Polias Legal is a research tool, not legal advice.
AI assistants (MCP)
Our MCP server https://api.polias.eu/mcp (Streamable HTTP, header
Authorization: Bearer <your key>) has the tool polias_legal_search with the
parameters query, country, court, type, area,
instance, from, to, cites, sort and
count. Your assistant can then research case law by itself. Settings for Claude, Cursor, VS Code,
LM Studio and others: api.polias.eu/examples.
claude mcp add --transport http polias https://api.polias.eu/mcp --header "Authorization: Bearer pol_YOUR_API_KEY"
Errors
| Code | Meaning |
|---|---|
400 | Invalid parameter; the message says which one and which values are allowed. Nothing is charged. |
401 | Key missing or unknown |
402 | Free requests and credit used up; top up in the portal |
403 | The key is bound to fixed IP addresses and the request comes from another one |
404 | /legal/document: no document with this id (free) |
429 | Too many requests per minute; the header Retry-After says how many seconds to wait |
502 | Temporarily unavailable, please try again shortly |
Questions: hallo@polias.eu.
Polias Legal: Rechts-Schnittstelle
Gerichtsentscheidungen, Gesetze und EU-Recht aus Deutschland, Österreich, der Schweiz, der Europäischen Union, Frankreich, den Niederlanden und Spanien über eine Schnittstelle. Filtern nach Gericht, Ebene, Instanz, Rechtsgebiet, Datum und zitierter Norm, sortieren nach Datum, und Volltext überall dort, wo die Lizenz es erlaubt. Jeder Treffer nennt Quelle und Lizenz.
Angebot und Preise Gleicher Schlüssel und gleiches Guthaben wie die Such-Schnittstelle: 1 € je 1.000 Anfragen, 1.000 im Monat kostenlos.
Schnellstart
Schlüssel im Kopf X-API-Key (oder Authorization: Bearer …) mitschicken und suchen:
curl -H "X-API-Key: pol_IHR_SCHLUESSEL" "https://api.polias.eu/v1/legal?q=K%C3%BCndigung&court=BAG&sort=date"
Noch kein Schlüssel? Hier bekommen: 1.000 Anfragen im Monat sind kostenlos. Der Schlüssel gehört auf Ihren Server, nie in Code, der im Browser läuft.
Adressen
GET /v1/legal
Suche in Entscheidungen und Normen mit allen Filtern unten. Deutscher Zweitname: /v1/recht.
GET /v1/legal/document?id=…
Ein Dokument per ECLI, CELEX, ELI oder Polias-ID: Angaben und Text, wo die Lizenz es erlaubt (Einzelheiten).
GET /v1/ki?scope=legal
Die KI-Suche nur in Rechtsquellen, mit denselben Filtern, gedacht für KI-Anwendungen.
GET /v1/search?result_filter=legal
Rechtstreffer als eigener Block neben Web oder Nachrichten (z. B. result_filter=web,legal). Alle Filter gibt es bei /v1/legal.
Angaben in der Adresse
Mehrere Werte in einer Angabe heißen ODER (mit Komma), verschiedene Angaben gelten zusammen (UND). Die Filter greifen, bevor die Treffer ausgewählt werden; auch ein enger Filter liefert volle Seiten, wenn es passende Dokumente gibt.
| Angabe | Werte | Beispiel |
|---|---|---|
q | Suchanfrage, Pflicht, höchstens 200 Zeichen. Aktenzeichen, ECLI und Zitate gehen auch. | q=Mietminderung Schimmel |
country | de, at, ch, eu, fr, nl, es | country=de,at |
level | eu, national (Bund), regional (Land, Kanton, Region) | level=regional |
region | ISO-3166-2-Kürzel, z. B. DE-NW, DE-BY, CH-ZH; kurz nw, wenn eindeutig | region=DE-NW |
court | ECLI-Gerichtskürzel oder übliche Abkürzung: DE:BGH / BGH, BAG, EU:C / CJEU / EuGH, EU:T, CH:BGER / BGer, AT:VFGH, NL:HR, FR:CCASS / Cass, FR:CE, FR:CC. Ein Anfang wählt eine Gruppe, z. B. FR:CAA (alle Verwaltungsberufungsgerichte); der Gerichtsname geht auch. | court=BGH |
instance | supreme, appeal, first | instance=supreme |
area | civil, criminal, administrative, labour, social, tax, constitutional | area=labour |
type | decision, leading_decision, opinion (Schlussanträge, Parket), statute, ordinance, treaty, legislation (alle Normen), eu_act, eu_regulation, eu_directive, eu_decision, parliamentary | type=leading_decision |
from, to | Datum als JJJJ, JJJJ-MM oder JJJJ-MM-TT; to=2023 heißt bis 31. Dezember 2023 | from=2024-01-01 |
sort | relevance (Standard), date (neueste zuerst unter den passendsten Treffern), date_asc | sort=date |
cites | Entscheidungen, die eine Norm zitieren; mehrere mit ;. Schreibweise wie im jeweiligen Land: § 536 BGB, Art. 271 OR, article L1234-9 code du travail, art. 7:658 BW, Art. 8 EMRK | cites=§ 280 BGB |
lang | Sprache des Dokuments bei mehrsprachigen Quellen (Schweiz, EU): de, fr, it, en, nl, es. In /v1/ki: legal_lang | lang=fr |
valid_on | Heute oder später. Wir halten die heute geltenden Fassungen; ein früheres Datum ergibt 400 mit Erklärung, statt Fassungen zu vermischen. | valid_on=2026-12-01 |
facets | 1: Anzahl je Gericht, Ebene, Land, Art, Rechtsgebiet, Instanz und Jahr über die passenden Kandidaten (facets_basis sagt, wie viele) | facets=1 |
count, offset | Treffer je Anfrage 1–10 (Standard 10); offset 0–40 für weitere Seiten (10 = Seite 2), jede Seite ist eine Anfrage | count=5 |
Die deutschen Namen (land, gericht, art, von, bis …) gehen weiter. Falsche Werte ergeben 400 mit Erklärung und kosten nichts.
Antwort
Oben: query, results, filter_documents (Dokumente im Index, die zu Ihren Filtern passen, unabhängig von der Suchanfrage), mit facets=1 zusätzlich facets und facets_basis, notice (z. B. wenn kein Dokument zu den Filtern passt) und usage.
| Feld je Treffer | Bedeutung |
|---|---|
id | Polias-ID, geht bei /legal/document |
title, url | Titel und Link zur amtlichen Quelle |
court, court_code | Gericht (bei Normen: die erlassende Stelle) und Kürzel, z. B. DE:BAG |
case_number, date | Aktenzeichen (bei Normen: Abkürzung oder Paragraf) und Datum |
country, level, region, instance, area | Wie bei den Filtern; area ist eine Liste |
type, leading | Art des Dokuments; leading kennzeichnet Leitentscheidungen |
ecli, celex, version | Kennungen, wo vorhanden; version bei Normen |
headnote | Amtlicher Leitsatz, wo das Gericht einen veröffentlicht |
cited_norms | Von der Entscheidung zitierte Normen |
excerpt | Kurzer passender Ausschnitt |
language | Sprache des Dokuments |
license, notice | Lizenz und Quellenangabe. Bitte notice mit dem Treffer anzeigen. |
ai_training | erlaubt: Die Lizenz erlaubt die Weiterverwendung des Textes (amtliche Werke, CC0, CC BY, Licence Ouverte, EUR-Lex); nur_suche: nur für die Suche, also Titel, Ausschnitt und Link verwenden |
Vorerst trägt jeder Treffer dieselben Felder zusätzlich mit deutschen Namen (gericht, aktenzeichen, datum …), oben stehen zusätzlich frage/treffer. Bitte die englischen Namen verwenden.
Volltext: /legal/document
curl -H "X-API-Key: pol_IHR_SCHLUESSEL" "https://api.polias.eu/v1/legal/document?id=ECLI:NL:HR:2026:1347"
id: ECLI, CELEX, ELI (lang oder kurz, z. B.eli/cc/2012/268) oder die Polias-id.- Die Antwort enthält
documentsmit den Feldern oben undtext, wo die Lizenz die Weiterverwendung erlaubt (ai_training: erlaubt). Sonst kommen der kurze Ausschnitt (bis 160 Zeichen) und der Link (heute: spanische Normen aus dem BOE). text_completesagt ehrlich, obtextdas ganze Dokument ist. Bei langen Urteilen und Gesetzen halten wir derzeit einen gekürzten Text: Dann isttext_completefalse,text_noteerklärt es, undurlführt zur vollständigen amtlichen Fassung.- Ein gefundenes Dokument zählt als eine Anfrage;
404(nicht gefunden) kostet nichts.
Beispiele
Deutschland: Entscheidungen des BAG zur Kündigung, neueste zuerst
curl -H "X-API-Key: pol_IHR_SCHLUESSEL" "https://api.polias.eu/v1/legal?q=K%C3%BCndigung+Arbeitsvertrag&court=BAG&sort=date"
Frankreich: Cour de cassation, Arbeitskammer, zur schweren Verfehlung
curl -H "X-API-Key: pol_IHR_SCHLUESSEL" "https://api.polias.eu/v1/legal?q=licenciement+faute+grave&court=Cass&area=labour"
EU: Gerichtshof zum Auskunftsrecht im Datenschutz seit 2023
curl -H "X-API-Key: pol_IHR_SCHLUESSEL" "https://api.polias.eu/v1/legal?q=Datenschutz+Auskunft&court=CJEU&from=2023&lang=de"
Schweiz: Bundesgericht, Entscheide mit Art. 271 OR (Miete)
curl -H "X-API-Key: pol_IHR_SCHLUESSEL" "https://api.polias.eu/v1/legal?q=Mietvertrag+K%C3%BCndigung&cites=Art.+271+OR&country=ch"
Python: suchen und Gericht, Aktenzeichen und Quellenangabe ausgeben
import json, os, urllib.parse, urllib.request
params = {"q": "Mietminderung Schimmel", "court": "BGH", "sort": "date", "count": 5}
request = urllib.request.Request("https://api.polias.eu/v1/legal?" + urllib.parse.urlencode(params),
headers={"X-API-Key": os.environ["POLIAS_API_KEY"]})
for hit in json.load(urllib.request.urlopen(request, timeout=15))["results"]:
print(hit["court"], hit["case_number"], hit["date"], hit["url"])
print(" ", hit.get("headnote") or hit.get("excerpt", ""))
print(" ", hit["notice"])
Mehr fertiger Code, Beispiel-Projekte und ein Baukasten: api.polias.eu/examples.
Abdeckung
Polias Legal nutzt nur amtliche, frei nutzbare Quellen. Jeder Treffer nennt Quelle und Lizenz.
Deutschland
Bundesgerichte (BVerfG, BGH, BVerwG, BFH, BAG, BSG, BPatG) über das Rechtsinformationsportal des Bundes, Entscheidungen aus Nordrhein-Westfalen und Bayern, Bundesgesetze und -verordnungen je Paragraf.Österreich
Verfassungsgerichtshof (VfGH) und Verwaltungsgerichtshof (VwGH).Schweiz
Bundesgericht mit Leitentscheiden, Bundesverwaltungsgericht und Bundesstrafgericht, auf Deutsch, Französisch und Italienisch.Europäische Union
Gerichtshof und Gericht mit Schlussanträgen, Verordnungen, Richtlinien und Beschlüsse aus EUR-Lex.Frankreich
Cour de cassation, Conseil d'État, Conseil constitutionnel, Verwaltungsberufungsgerichte und Berufungsgerichte, dazu die Gesetzbücher (Codes) von Légifrance (DILA, Licence Ouverte).Niederlande
Hoge Raad mit den Schlussanträgen des Parket, Raad van State, Centrale Raad van Beroep, College van Beroep voor het bedrijfsleven, die Gerechtshoven und Rechtbanken (rechtspraak.nl, CC0).Spanien
Gesamtstaatliche Normen aus dem BOE, für die Suche (Titel, Ausschnitt, Link).Entscheidungen liefern wir so, wie die Gerichte sie veröffentlichen (anonymisiert oder pseudonymisiert). Die Treffer dürfen nicht genutzt werden, um Personen wiederzuerkennen; siehe Nr. 4 der Bedingungen der Such-Schnittstelle. Polias Legal ist ein Recherche-Werkzeug, keine Rechtsberatung.
KI-Assistenten (MCP)
Unser MCP-Server https://api.polias.eu/mcp (Streamable HTTP, Kopf
Authorization: Bearer <Ihr Schlüssel>) hat das Werkzeug polias_legal_search mit
den Angaben query, country, court, type, area,
instance, from, to, cites, sort und
count. Ihr Assistent recherchiert dann selbst in der Rechtsprechung. Einstellungen für Claude,
Cursor, VS Code, LM Studio und andere: api.polias.eu/examples.
claude mcp add --transport http polias https://api.polias.eu/mcp --header "Authorization: Bearer pol_IHR_SCHLUESSEL"
Fehler
| Code | Bedeutung |
|---|---|
400 | Ungültige Angabe; die Meldung sagt, welche und welche Werte erlaubt sind. Kostet nichts. |
401 | Schlüssel fehlt oder unbekannt |
402 | Kostenlose Anfragen und Guthaben aufgebraucht; im Portal aufladen |
403 | Der Schlüssel ist an feste IP-Adressen gebunden, die Anfrage kommt von einer anderen |
404 | /legal/document: kein Dokument mit dieser ID (kostenlos) |
429 | Zu viele Anfragen je Minute; der Kopf Retry-After sagt, wie viele Sekunden zu warten sind |
502 | Kurz nicht erreichbar, bitte gleich noch einmal versuchen |
Fragen: hallo@polias.eu.