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.

ParameterValuesExample
qQuery, required, up to 200 characters. Case numbers, ECLI and citations work too.q=Mietminderung Schimmel
countryde, at, ch, eu, fr, nl, escountry=de,at
leveleu, national (federal), regional (state, canton, region)level=regional
regionISO 3166-2 code, e.g. DE-NW, DE-BY, CH-ZH; the short form nw works if uniqueregion=DE-NW
courtECLI 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
instancesupreme, appeal, firstinstance=supreme
areacivil, criminal, administrative, labour, social, tax, constitutionalarea=labour
typedecision, leading_decision, opinion (Advocate General, Parket), statute, ordinance, treaty, legislation (all norms), eu_act, eu_regulation, eu_directive, eu_decision, parliamentarytype=leading_decision
from, toDate as YYYY, YYYY-MM or YYYY-MM-DD; to=2023 means until 31 December 2023from=2024-01-01
sortrelevance (default), date (newest first among the most relevant matches), date_ascsort=date
citesDecisions 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 ECHRcites=§ 280 BGB
langLanguage of the document for multilingual sources (Switzerland, EU): de, fr, it, en, nl, es. In /v1/ki: legal_langlang=fr
valid_onToday 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
facets1: counts per court, level, country, type, area, instance and year over the matching candidates (facets_basis says how many)facets=1
count, offsetResults per request 1–10 (default 10); offset 0–40 for the next pages (10 = page 2), each page is one requestcount=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 resultMeaning
idPolias id; works with /legal/document
title, urlTitle and link to the official source
court, court_codeCourt (for legislation: the issuing body) and its ECLI-style code, e.g. DE:BAG
case_number, dateCase number (for legislation: the abbreviation or section) and date
country, level, region, instance, areaAs in the filters; area is a list
type, leadingDocument type; leading marks leading decisions
ecli, celex, versionIdentifiers where they exist; version for legislation
headnoteOfficial headnote where published by the court
cited_normsProvisions cited by the decision
excerptShort passage matching the query
languageLanguage of the document
license, noticeLicence and source notice. Please show notice with the result.
ai_trainingerlaubt: 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"

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

CodeMeaning
400Invalid parameter; the message says which one and which values are allowed. Nothing is charged.
401Key missing or unknown
402Free requests and credit used up; top up in the portal
403The key is bound to fixed IP addresses and the request comes from another one
404/legal/document: no document with this id (free)
429Too many requests per minute; the header Retry-After says how many seconds to wait
502Temporarily unavailable, please try again shortly

Questions: hallo@polias.eu.

← Search API

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.

AngabeWerteBeispiel
qSuchanfrage, Pflicht, höchstens 200 Zeichen. Aktenzeichen, ECLI und Zitate gehen auch.q=Mietminderung Schimmel
countryde, at, ch, eu, fr, nl, escountry=de,at
leveleu, national (Bund), regional (Land, Kanton, Region)level=regional
regionISO-3166-2-Kürzel, z. B. DE-NW, DE-BY, CH-ZH; kurz nw, wenn eindeutigregion=DE-NW
courtECLI-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
instancesupreme, appeal, firstinstance=supreme
areacivil, criminal, administrative, labour, social, tax, constitutionalarea=labour
typedecision, leading_decision, opinion (Schlussanträge, Parket), statute, ordinance, treaty, legislation (alle Normen), eu_act, eu_regulation, eu_directive, eu_decision, parliamentarytype=leading_decision
from, toDatum als JJJJ, JJJJ-MM oder JJJJ-MM-TT; to=2023 heißt bis 31. Dezember 2023from=2024-01-01
sortrelevance (Standard), date (neueste zuerst unter den passendsten Treffern), date_ascsort=date
citesEntscheidungen, 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 EMRKcites=§ 280 BGB
langSprache des Dokuments bei mehrsprachigen Quellen (Schweiz, EU): de, fr, it, en, nl, es. In /v1/ki: legal_langlang=fr
valid_onHeute 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
facets1: Anzahl je Gericht, Ebene, Land, Art, Rechtsgebiet, Instanz und Jahr über die passenden Kandidaten (facets_basis sagt, wie viele)facets=1
count, offsetTreffer je Anfrage 1–10 (Standard 10); offset 0–40 für weitere Seiten (10 = Seite 2), jede Seite ist eine Anfragecount=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 TrefferBedeutung
idPolias-ID, geht bei /legal/document
title, urlTitel und Link zur amtlichen Quelle
court, court_codeGericht (bei Normen: die erlassende Stelle) und Kürzel, z. B. DE:BAG
case_number, dateAktenzeichen (bei Normen: Abkürzung oder Paragraf) und Datum
country, level, region, instance, areaWie bei den Filtern; area ist eine Liste
type, leadingArt des Dokuments; leading kennzeichnet Leitentscheidungen
ecli, celex, versionKennungen, wo vorhanden; version bei Normen
headnoteAmtlicher Leitsatz, wo das Gericht einen veröffentlicht
cited_normsVon der Entscheidung zitierte Normen
excerptKurzer passender Ausschnitt
languageSprache des Dokuments
license, noticeLizenz und Quellenangabe. Bitte notice mit dem Treffer anzeigen.
ai_trainingerlaubt: 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"

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

CodeBedeutung
400Ungültige Angabe; die Meldung sagt, welche und welche Werte erlaubt sind. Kostet nichts.
401Schlüssel fehlt oder unbekannt
402Kostenlose Anfragen und Guthaben aufgebraucht; im Portal aufladen
403Der Schlüssel ist an feste IP-Adressen gebunden, die Anfrage kommt von einer anderen
404/legal/document: kein Dokument mit dieser ID (kostenlos)
429Zu viele Anfragen je Minute; der Kopf Retry-After sagt, wie viele Sekunden zu warten sind
502Kurz nicht erreichbar, bitte gleich noch einmal versuchen

Fragen: hallo@polias.eu.

← Zur Such-Schnittstelle