API

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

Account erstellen

1.000 Suchanfragen / Monat
50 Case-Law-Abrufe / Monat
10 Suchanfragen / 5 Case-Law pro Minute
Keine Überschreitung
Community-Support

Startup

Für Produkte mit echten Nutzern.

299 €/ Monat

Vertrieb kontaktieren

50.000 Suchanfragen / Monat
1.000 Case-Law-Abrufe / Monat
60 / 30 Anfragen pro Minute
Überschreitung: 0,01 € / Suche · 0,20 € / Case-Law
E-Mail-Support

Business

Für skalierende Legal-Tech-Produkte.

1.490 €/ Monat

Vertrieb kontaktieren

500.000 Suchanfragen / Monat
5.000 Case-Law-Abrufe / Monat
300 / 150 Anfragen pro Minute
Überschreitung: 0,005 € / Suche · 0,15 € / Case-Law
Auftragsverarbeitungsvertrag

Enterprise

Verlage, Kanzleigruppen und Behörden.

Individuell

Vertrieb kontaktieren

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

„Suchanfragen“ umfassen Such- und Listenaufrufe; „Case-Law-Abrufe“ den Volltext-Abruf einzelner Entscheidungen und Dokumente. Bei ausgeschöpftem Kontingent antwortet die API mit 429 Too Many Requests.

Dokumentation

Eine schlanke, API-Key-authentifizierte REST-Schnittstelle für die Integration von Themis in Ihre eigenen Anwendungen.

Authentifizierung

Jede Anfrage wird mit einem organisationsgebundenen API-Schlüssel authentifiziert. Übergeben Sie ihn als Authorization: Bearer-Header oder als X-Api-Key-Header. Schlüssel erstellen und widerrufen Sie unter Team → API-Zugang.

curl https://api.themislegal.de/v1/decisions \
  -H "Authorization: Bearer tk_…"

Fehlt der Schlüssel oder ist er ungültig bzw. widerrufen, antwortet die API mit 401 Unauthorized.

Basis-URL & Format

Alle Endpunkte liegen unter der Version /v1. Anfragen und Antworten sind JSON.

https://api.themislegal.de/v1

Kontingente & Rate-Limits

Der Verbrauch wird in zwei monatlichen Kontingenten pro Organisation geführt:

search — Such- und Listenaufrufe (/v1/search, /v1/decisions, /v1/documents).
retrieve — Volltext-Abrufe einzelner Datensätze (/v1/decisions/{id}, /v1/documents/{id}).

Die Monatskontingente richten sich nach Ihrem Tarif und werden zu Beginn jeder Abrechnungsperiode zurückgesetzt. Ist ein Kontingent ausgeschöpft, antwortet die API mit 429 Too Many Requests — sofern Überschreitung in Ihrem Tarif nicht aktiviert ist.

Endpunkte

GET/v1/searchsearch-Kontingent

Modus-bewusste Hybrid-Suche (BM25 + Vektor) über Rechtsprechung und – mit gültigem Key – die Bibliothek Ihrer Organisation.

Parameter	Typ	Beschreibung
`q`	string, erforderlich	Freitext-Suchanfrage.
`scope`	all \| decisions \| documents	Welcher Korpus durchsucht wird. Standard: all.
`mode`	PRAXIS \| AKTUELL \| LEITENTSCHEIDUNGEN \| WISSENSCHAFT	Ranking-Voreinstellung. Standard: PRAXIS.
`limit`	integer (1–100)	Obergrenze der Trefferzahl. Sonst adaptiv über einen Relevanz-Cutoff.
`aiRerank`	boolean	KI-Reranking auf die Top-Treffer anwenden. Standard: false.

GET/v1/decisionssearch-Kontingent

Paginierte Übersicht der Gerichtsentscheidungen (neueste zuerst), ohne Volltext.

Parameter	Typ	Beschreibung
`page`	integer (≥ 1)	1-basierte Seitennummer. Standard: 1.
`pageSize`	integer (1–100)	Einträge pro Seite. Standard: 50.
`court`	string	Nach Gericht filtern (exakter Treffer), z. B. BGH.
`decisionType`	string	Nach Entscheidungsart filtern, z. B. Urteil.

GET/v1/decisions/{id}retrieve-Kontingent

Eine einzelne Entscheidung mit strukturiertem Volltext, Leitsätzen, zitierten Normen und zitierten Entscheidungen.

Parameter	Typ	Beschreibung
`id`	Pfadparameter	Stabile, quellenseitige ID (z. B. ECLI).

GET/v1/documentssearch-Kontingent

Übersicht der Bibliotheks-Dokumente Ihrer Organisation (neueste zuerst), ohne Volltext.

GET/v1/documents/{id}retrieve-Kontingent

Ein Dokument Ihrer Organisation inklusive des extrahierten Volltexts.

Parameter	Typ	Beschreibung
`id`	Pfadparameter	Dokument-ID.

Beispiel: Suche

Eine Suche im Modus PRAXIS:

curl "https://api.themislegal.de/v1/search?q=Schadensersatz+nach+Verkehrsunfall&mode=PRAXIS" \
  -H "Authorization: Bearer tk_…"

Antwort (gekürzt):

{
  "query": "Schadensersatz nach Verkehrsunfall",
  "mode": "PRAXIS",
  "aiReranked": false,
  "results": [
    {
      "sourceType": "DECISION",
      "sourceId": "ECLI:DE:BGH:2024:150324UVIZR1.24.0",
      "score": 87.4,
      "title": "Haftung bei Auffahrunfall",
      "court": "BGH",
      "fileNumber": "VI ZR 1/24",
      "decisionDate": "2024-03-15T00:00:00.000Z",
      "snippet": "Der Schädiger haftet …",
      "decisionType": "Urteil",
      "keywords": ["Deliktsrecht"],
      "citationCount": 12
    }
  ]
}

Die Liste der Entscheidungen ist paginiert:

{
  "data": [
    {
      "id": "ECLI:DE:BGH:2024:150324UVIZR1.24.0",
      "ecli": "ECLI:DE:BGH:2024:150324UVIZR1.24.0",
      "fileNumber": "VI ZR 1/24",
      "court": "BGH",
      "courtType": "Bundesgericht",
      "decisionDate": "2024-03-15T00:00:00.000Z",
      "decisionType": "Urteil",
      "title": "Haftung bei Auffahrunfall",
      "sourceUrl": "https://www.bundesgerichtshof.de/…",
      "createdAt": "2024-03-15T00:00:00.000Z"
    }
  ],
  "total": 1234,
  "page": 1,
  "pageSize": 50
}

OpenAPI & Referenz

Die vollständige, interaktive Referenz steht als Swagger-UI unter https://api.themislegal.de/swagger bereit; das OpenAPI-Schema unter https://api.themislegal.de/docs-json.

Bereit für den produktiven Einsatz?

Erstellen Sie einen kostenlosen Developer-Key oder sprechen Sie mit unserem Team über höhere Limits.

Vertrieb Loslegen