Juristische Recherche-Workflows mit LexGraph Daten bauen

Verbindung

Base URL: https://api.lexgraph.de

Sende bei jedem Request einen Bearer API-Key.

Was in LexGraph steckt

LexGraph modelliert juristische Inhalte als verknüpfte Entities. Die API arbeitet mit denselben Grundtypen wie die Datenbank und gibt sie je nach Endpunkt als Suchtreffer, Volltexte, Referenzen oder Antwortkontext zurück.

• Kommentar: Kuratiertes juristisches Wissen: Begriffe, Prüfungspunkte, Einordnungen und Kommentartexte, die Normen und Entscheidungen fachlich verbinden.
• Norm: Deutsche Normen mit Paragraphen, Artikeln, Absätzen, Sätzen und strukturierter Gesetzbuch-Navigation.
• EU-Rechtsakt: Europäische Verordnungen, Richtlinien und Beschlüsse, inklusive Artikelstruktur und CELEX-fähigen Referenzen.
• Entscheidung: Deutsche court_cases mit Gericht, Aktenzeichen, Datum, Rechtsgebiet, Leitsatz, Verfahrensgang, Volltextfeldern, Randnummern und Zitierbeziehungen.
• Europäische Entscheidung: EuGH- und EuG-Entscheidungen mit Aktenzeichen, ECLI-Werten und Verweisen auf europäische Rechtsakte.
• Nachweis: Fundstellen, Zitierungen und Verweise wie Aktenzeichen, Papierfundstellen, Drucksachen oder BGBl-Nachweise, die Entities im Graphen belegbar verbinden.
• Beziehung: Beziehungen verbinden zwei Entities im Graphen. Sie tragen ein Gewicht und eine Beschreibung im Freitextformat, damit Stärke, Relevanz und fachlicher Kontext der Verbindung nachvollziehbar bleiben.
• Permalink: Alle gefundenen Entitäten sind über den Permalink in unserer Datenbank einsehbar.

Schnellstart

Starte mit dem Answer-Endpunkt, wenn LexGraph juristischen Kontext finden und in einem Call eine Antwort erzeugen soll.

Bearer API-Keys

Jeder Request braucht einen Authorization-Header. Ungültige Keys liefern 401 mit Invalid API key.

Antwortformate

Suchendpunkte geben entities und count zurück. Setze "relationships": true, um zusätzlich ein relationships-Array zu erhalten; "permalinks": true ergänzt browserfertige LexGraph-Links, sofern sie erzeugt oder gefunden werden können.

Filter

Alle direkten Search-Endpunkte und POST /v1/answer akzeptieren dasselbe optionale filters-Objekt. Es grenzt Ergebnisse hart anhand der in LexGraph gespeicherten oder zuverlässig abgeleiteten Metadaten ein.

Filters-Schema

type SearchRegion =
  | "Bund"
  | "EU"
  | "Baden-Württemberg"
  | "Bayern"
  | "Berlin"
  | "Brandenburg"
  | "Bremen"
  | "Hamburg"
  | "Hessen"
  | "Mecklenburg-Vorpommern"
  | "Niedersachsen"
  | "Nordrhein-Westfalen"
  | "Rheinland-Pfalz"
  | "Saarland"
  | "Sachsen"
  | "Sachsen-Anhalt"
  | "Schleswig-Holstein"
  | "Thüringen";

type SearchFilters = {
  rechtsgebiete?: string[];
  regionen?: SearchRegion[];
  gerichte?: string[];
  zeitraum?: {
    von?: "YYYY-MM-DD";
    bis?: "YYYY-MM-DD";
  };
};

Unterstützte Filterwerte

Wechsle zwischen den Filterfeldern, um die kanonischen LexGraph-Werte und das erwartete Format zu sehen.

Rechtsgebiete

Diese kanonischen Werte werden in LexGraph verwendet. Das API-Feld akzeptiert Strings, sollte für verlässliche Treffer aber einen dieser Werte enthalten.

• Agrarrecht
• Arbeitsrecht
• Bank- und Kapitalmarktrecht
• Bau- und Architektenrecht
• Beamten und Dienstrecht
• Berufsrecht
• Energierecht
• Erbrecht
• Europarecht
• Familienrecht
• Gewerblicher Rechtsschutz
• Handels- und Gesellschaftsrecht
• Immobilienrecht
• Insolvenzrecht
• IT-Recht
• Kartellrecht
• Medizinrecht
• Mietrecht / WEG
• Migrationsrecht
• Ordnungswidrigkeiten
• Sonstiges
• Sozialrecht
• Steuerrecht
• Strafrecht
• Transport- und Speditionsrecht
• Umweltrecht
• Urheberrecht und Medienrecht
• Verfassungsrecht
• Vergaberecht
• Verkehrsrecht
• Versicherungsrecht
• Verwaltungsrecht
• Zivil- und Zivilprozessrecht

Regionen

Dies ist die vollständige Liste der vom Request-Schema akzeptierten Regionen. Die Werte müssen exakt wie angezeigt übergeben werden.

• Bund
• EU
• Baden-Württemberg
• Bayern
• Berlin
• Brandenburg
• Bremen
• Hamburg
• Hessen
• Mecklenburg-Vorpommern
• Niedersachsen
• Nordrhein-Westfalen
• Rheinland-Pfalz
• Saarland
• Sachsen
• Sachsen-Anhalt
• Schleswig-Holstein
• Thüringen

Gerichte

Verwende den standardisierten Code, nicht den ausgeschriebenen Gerichtsnamen. Europäische Gerichte werden bei aktiven Filtern derzeit nicht durchsucht.

Ordentliche Gerichtsbarkeit

• AG — Amtsgericht
• LG — Landgericht
• OLG — Oberlandesgericht
• BGH — Bundesgerichtshof
• Schiffobergericht — Schifffahrtsobergericht
• BPatG — Bundespatentgericht
• BayObLG — Bayerisches Oberstes Landesgericht

Arbeitsgerichtsbarkeit

• ArbG — Arbeitsgericht
• LAG — Landesarbeitsgericht
• BAG — Bundesarbeitsgericht

Verwaltungsgerichtsbarkeit

• VG — Verwaltungsgericht
• OVG — Oberverwaltungsgericht
• BVerwG — Bundesverwaltungsgericht
• Dienstgericht — Dienstgericht
• Dienstgerichtshof — Dienstgerichtshof
• Truppendienstgericht — Truppendienstgericht

Sozialgerichtsbarkeit

• SG — Sozialgericht
• LSG — Landessozialgericht
• BSG — Bundessozialgericht

Finanzgerichtsbarkeit

• FG — Finanzgericht
• BFH — Bundesfinanzhof

Verfassungsgerichtsbarkeit

• VerfG — Landesverfassungsgericht
• BVerfG — Bundesverfassungsgericht

Sonstige

• Vergabekammer — Vergabekammer
• STA — Staatsanwaltschaft
• GmSOGB — Gemeinsamer Senat
• BerGer — Berufsgericht
• BerGH — Berufsgerichtshof
• ÄrztGerHof — Ärztegerichtshof

Zeitraum

Der Zeitraum hat keine feste Werteliste. von und bis akzeptieren jeweils ein inklusives Kalenderdatum im ISO-Format YYYY-MM-DD.

• Nur ab Datum: { "von": "2020-01-01" }
• Nur bis Datum: { "bis": "2026-08-14" }
• Geschlossener Zeitraum: { "von": "2020-01-01", "bis": "2026-08-14" }

Kombinations- und Validierungslogik

• Alle vier Felder sind optional; unbekannte Felder in filters oder zeitraum werden mit 422 abgelehnt.
• Mehrere Werte innerhalb eines Arrays werden mit OR verknüpft. Nicht-leere, für eine Quelle anwendbare Dimensionen werden mit AND verknüpft.
• gerichte wird gegen standardisierte Gerichtscodes wie BAG, LAG oder BGH abgeglichen; regionen akzeptiert Bund, EU oder den Namen eines Bundeslandes.
• zeitraum.von und zeitraum.bis sind inklusive Grenzen im ISO-Format YYYY-MM-DD; von darf nicht nach bis liegen.

Anwendbare Dimensionen nach Quelle

Gefilterter Request

{
  "query": "Welche arbeitsrechtlichen Entscheidungen des BAG seit 2020 sind relevant?",
  "filters": {
    "rechtsgebiete": [
      "Arbeitsrecht"
    ],
    "regionen": [
      "Bund",
      "Berlin"
    ],
    "gerichte": [
      "BAG",
      "LAG"
    ],
    "zeitraum": {
      "von": "2020-01-01",
      "bis": "2026-08-14"
    }
  },
  "limit": 20
}

Aktuelle Abdeckung

• Eine für eine Quelle nicht anwendbare Dimension entfernt diese Quelle nicht aus dem Ergebnis. Fehlen bei Nachweisen oder Beispielen anwendbare Metadaten, werden sie konservativ ausgeschlossen.
• Bei aktiven Filtern werden EU-Rechtsakte und europäische Gerichtsentscheidungen vorerst nicht berücksichtigt.
• Landesrecht wird ohne Embeddings über konfigurierte Arango Views gesucht. Views bestehen derzeit für Baden-Württemberg, Bayern, Berlin, Hamburg, Hessen, Mecklenburg-Vorpommern, Saarland, Sachsen-Anhalt, Schleswig-Holstein und Thüringen. Für die übrigen sechs Bundesländer wird derzeit kein Landesrechts-View abgefragt; regionale Entscheidungsfilter funktionieren weiterhin.

Rate-, Wochen- und Zeichenlimits

Ein Limitwert von -1 bedeutet unbegrenzt. Suchendpunkte nutzen wöchentliche Search-Zähler; /v1/answer nutzt wöchentliche Answer-Zähler.

Datenquellen

data_sources begrenzt die angefragten Quelltypen. Zulässige Werte hängen vom Endpunkt ab; die jeweilige Endpunktbeschreibung ist maßgeblich.

Graph Search durchsucht intern alle graphfähigen Quellen und nutzt data_sources als finalen Output-Filter. limit bleibt eine Obergrenze, und Quality Control kann count weiter reduzieren.

Limit-Header

Responses enthalten Metadaten zu Rate Limits. Search- und Answer-Endpunkte liefern zusätzlich wöchentliche Zähler für ihre jeweilige Quota-Gruppe.

• X-RateLimit-Limit: Request-Limit für das aktuelle Fenster.
• X-RateLimit-Remaining: Verbleibende Requests im aktuellen Fenster.
• X-RateLimit-Reset: Zeitpunkt, zu dem das Fenster zurückgesetzt wird.
• X-SearchLimit-*: Metadaten zur wöchentlichen Search-Quota.
• X-AnswerLimit-*: Metadaten zur wöchentlichen Answer-Quota.
• Retry-After: Sekunden bis zum nächsten Versuch nach 429.

Endpunkte

Diese Endpunkte decken Antwortgenerierung, Referenzextraktion, Nachweisprüfung und den Volltextabruf bekannter Entscheidungen ab.

Fehler

Fehlerantworten nutzen HTTP-Statuscodes. Verwende Statuscode und Response-Detail, um zu entscheiden, ob du retryen, den Request ändern oder Credentials prüfen solltest.

• 401: API-Key fehlt oder ist ungültig.
• 403: Key ist deaktiviert, abgelaufen oder der erforderliche Scope fehlt.
• 404: Angefragte Entscheidung oder Entity wurde nicht gefunden.
• 413: text oder query überschreitet max_chars_per_request.
• 422: Request-Schema, Filterwerte oder data_sources sind ungültig bzw. werden nicht unterstützt.
• 429: Rate-, Zeichen-, Search- oder Answer-Limit wurde überschritten.
• 503: Backend für Referenzextraktion oder Antwortgenerierung ist nicht verfügbar.