API-Dokumentation

Deutsche Rechtsprechung. Als HTTP-API.

Zwei Endpoints — Suche und Einzelentscheidung. JSON-Antworten, Bearer-Auth, Rate-Limits pro Plan. Gehostet in Frankfurt, kein Tracking, keine Trainingsnutzung.

https://api.chat.themislegal.deREST · JSON
Hosting in FrankfurtTLS & Bearer-AuthDSGVO & BDSGKI-Re-Ranking
Endpoints

Zwei Endpoints. Mehr brauchen Sie nicht.

REST mit JSON-Body, klare Statuscodes (200, 401, 404, 429), KI-Re-Ranking standardmäßig aktiviert.

POST/v1/public/searchRechtsprechung durchsuchen

Volltext- und semantische Suche über die deutsche Rechtsprechung. Jede Anfrage läuft mit aktivierter KI-gestützter Query-Expansion und Re-Ranking. Antwort enthält die Treffer als kompaktes Summary-Objekt mit Relevanz-Score.

Parameter

  • queryrequiredstring
    Suchanfrage in natürlicher Sprache, mit Aktenzeichen oder Stichworten.
  • courtsstring[]
    Filter auf bestimmte Gerichte, z. B. ["BGH", "OLG München"].
  • documentTypesstring[]
    Entscheidungsart, z. B. ["Urteil", "Beschluss"].
  • legalAreasstring[]
    Rechtsgebiet, z. B. ["Zivilrecht", "Strafrecht"].
  • dateFromISO-8601
    Frühestes Entscheidungsdatum (inklusive).
  • dateToISO-8601
    Spätestes Entscheidungsdatum (inklusive).
  • limitinteger
    Anzahl Treffer (1–50, Default 20).
Requestbash
curl https://api.chat.themislegal.de/v1/public/search \
  -H "Authorization: Bearer thm_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Mietminderung Schimmel",
    "courts": ["BGH", "OLG München"],
    "limit": 10
  }'
Response · 200 OKjson
{
  "results": [
    {
      "id": "bgh-i-zr-12-23-2024-01-01",
      "ecli": "ECLI:DE:BGH:2024:010124U1ZR12.23.0",
      "aktenzeichen": "I ZR 12/23",
      "court": "BGH",
      "courtType": "BGH – Bundesgerichtshof",
      "decisionDate": "2024-01-01T00:00:00.000Z",
      "title": "Mietminderung wegen Schimmelbefall ...",
      "sourceUrl": "https://www.rechtsprechung-im-internet.de/...",
      "summary": "Der Bundesgerichtshof entschied ...",
      "rechtsgebietHauptgebiet": "Zivilrecht",
      "rechtsgebietTeilgebiete": ["Mietrecht"],
      "score": 0.87
    }
  ],
  "limit": 10
}
GET/v1/public/case-laws/:idEinzelne Entscheidung abrufen

Liefert die vollständige Entscheidung — Leitsätze, Orientierungssatz, Tenor, Tatbestand, Entscheidungsgründe, zitierte Normen, Keywords und Metadaten. Die ID stammt aus dem Suchergebnis.

Parameter

  • idrequiredstring
    Stabile Themis-ID der Entscheidung (Pfadparameter).
Requestbash
curl https://api.chat.themislegal.de/v1/public/case-laws/bgh-i-zr-12-23-2024-01-01 \
  -H "Authorization: Bearer thm_live_..."
Response · 200 OKjson
{
  "id": "bgh-i-zr-12-23-2024-01-01",
  "ecli": "ECLI:DE:BGH:2024:010124U1ZR12.23.0",
  "aktenzeichen": "I ZR 12/23",
  "court": "BGH",
  "courtType": "BGH – Bundesgerichtshof",
  "decisionDate": "2024-01-01T00:00:00.000Z",
  "title": "Mietminderung wegen Schimmelbefall ...",
  "source": "rechtsprechung-im-internet",
  "sourceUrl": "https://www.rechtsprechung-im-internet.de/...",
  "country": "DE",
  "rechtsgebietHauptgebiet": "Zivilrecht",
  "rechtsgebietTeilgebiete": ["Mietrecht"],
  "rechtssaetze": ["..."],
  "leitsatz":         [{ "text": "..." }],
  "orientierungssatz":[{ "text": "..." }],
  "tenor":            [{ "text": "..." }],
  "tatbestand":       [{ "text": "..." }],
  "entscheidungsgruende": [{ "text": "..." }],
  "norms":  [{ "norm": "BGB", "paragraphs": ["536"] }],
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-01T00:00:00.000Z"
}
Authentifizierung

Ein Bearer-Token. Mehr nicht.

Erstellen Sie einen API-Key in Ihrem Themis-Account und schicken Sie ihn als Bearer-Token im Authorization-Header. Keys mit Prefix thm_test_ verbrauchen Ihr Test-Kontingent, Keys mit thm_live_ laufen gegen Ihre Produktions-Limits.

  • HMAC-Hash, kein Klartext

    Wir speichern nur den Hash Ihres Keys. Verloren gegangene Keys können nur ersetzt, nicht wiederhergestellt werden.

  • Pro-Minute- und Monats-Limits

    Beide Limits gelten je Plan. Bei Überschreitung antwortet die API mit 429 und retryAfterSeconds.

  • Test- und Live-Keys getrennt

    Im Developer-Plan sind nur Test-Keys verfügbar. Ab Startup-Plan können Sie Live-Keys ausstellen.

example.tsTypeScript
// TypeScript / Node.js — ohne SDK, nur fetch
const res = await fetch("https://api.chat.themislegal.de/v1/public/search", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.THEMIS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query: "Mietminderung Schimmel",
    courts: ["BGH", "OLG München"],
    dateFrom: "2020-01-01",
    limit: 10,
  }),
});

if (!res.ok) {
  throw new Error(`Themis API ${res.status}: ${await res.text()}`);
}

const { results } = await res.json();
Einsatzgebiete

Was Sie damit bauen können.

Vier typische Einsatzgebiete — von eigenständigen Legal-Tech-Produkten bis zur kanzleiinternen Integration.

Legal-Tech-Produkte

Mandantenportale, Prüfassistenten oder Dokumentenautomatisierung mit aktueller deutscher Rechtsprechung.

RAG für KI-Anwendungen

Versorgen Sie Ihr Sprachmodell mit belastbaren Quellen — semantische Suche und Volltext über deutsche Entscheidungen.

Verlage & Publikationen

Volltext-Entscheidungen in Kommentare, Lehrbücher und Online-Datenbanken integrieren.

Kanzlei-intern

Eigene Tools für Wissensmanagement, Precedent-Tracking oder Mandatsbewertung.

Preise

Faire API-Preise. Echte Limits.

Limits gelten pro Minute und pro Abrechnungsperiode. Überschreitung ist optional aktivierbar — wir drosseln nicht still.

Developer

Für Evaluierung und Prototypen.

Kostenlos
  • 1.000 Suchanfragen / Monat
  • 50 Case-Law-Abrufe / Monat
  • 10 Suchanfragen / 5 Case-Law pro Minute
  • Nur Test-Keys (thm_test_…)
  • Keine Überschreitung
  • Community-Support
Account erstellen
Empfohlen

Startup

Für Produkte mit echten Nutzern.

299 €/ Monat
  • 50.000 Suchanfragen / Monat
  • 1.000 Case-Law-Abrufe / Monat
  • 60 / 30 Anfragen pro Minute
  • Live-Keys (thm_live_…)
  • Überschreitung: 0,01 € / Suche · 0,20 € / Case-Law
  • E-Mail-Support
Vertrieb kontaktieren

Business

Für skalierende Legal-Tech-Produkte.

1.490 €/ Monat
  • 500.000 Suchanfragen / Monat
  • 5.000 Case-Law-Abrufe / Monat
  • 300 / 150 Anfragen pro Minute
  • Live-Keys (thm_live_…)
  • Überschreitung: 0,005 € / Suche · 0,15 € / Case-Law
  • Auftragsverarbeitungsvertrag
Vertrieb kontaktieren

Enterprise

Verlage, Kanzleigruppen, Behörden — inklusive Bulk-Export-Lizenz.

Individuell
  • Unbegrenzte Such- und Case-Law-Anfragen
  • Individuelle Rate-Limits
  • Bulk-Export der Rechtsprechungs-Datenbank
  • Custom SLA
  • Technischer Account Manager
Vertrieb kontaktieren
FAQ

Häufige Fragen.

Welche Gerichte sind abgedeckt?+

BVerfG, BGH, Bundesarbeitsgericht, Bundesfinanzhof, Bundessozialgericht, Bundesverwaltungsgericht sowie OLGs, LGs, AGs und die Fachgerichtsbarkeiten. Neue Entscheidungen werden werktags indexiert.

Wie aktuell sind die Daten?+

Höchstgerichte werden in der Regel innerhalb von 24 Stunden nach Veröffentlichung indexiert. Instanzgerichte typischerweise innerhalb weniger Werktage.

Darf ich die Daten weiterverarbeiten?+

Ja. Entscheidungen sind amtliche Werke und nach § 5 UrhG gemeinfrei. Unsere aufbereiteten Metadaten und Embeddings unterliegen unserer Nutzungslizenz — Details im AV-Vertrag.

Was passiert beim Ratenlimit?+

HTTP 429 mit dem Feld retryAfterSeconds in der Antwort. Pro-Minute-Limits gelten je Plan; das Monatskontingent kann bei Startup- und Business-Plänen optional als Überschreitung weiterlaufen.

Wo werden die Daten gehostet?+

Frankfurt am Main, Deutschland. Auftragsverarbeitungsvertrag ab Business-Plan inklusive.

Gibt es einen offiziellen SDK-Client?+

Aktuell nicht. Die API ist bewusst schlank gehalten — REST + JSON, ein Bearer-Token. Jeder HTTP-Client funktioniert.

API-Key in 60 Sekunden.

Erstellen Sie einen Themis-Account und legen Sie Ihren ersten API-Key im Dashboard an. Der Developer-Plan ist kostenlos und beinhaltet 1.000 Requests pro Monat.

Account erstellen MCP-Server für Claude