Crea flujos de investigación jurídica con datos de LexGraph

Conexión

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

Envía una clave API bearer en cada request.

Qué contiene LexGraph

LexGraph modela materiales jurídicos como entidades conectadas. La API trabaja con los mismos tipos básicos que la base de datos y los devuelve como resultados de búsqueda, textos completos, referencias o contexto de respuesta según el endpoint.

• Comentario: Conocimiento jurídico curado: términos, estructuras de análisis, explicaciones y comentarios que conectan normas y resoluciones.
• Norma: Normas alemanas con secciones, artículos, párrafos, frases y navegación estructurada del código.
• Acto jurídico de la UE: Reglamentos, directivas y decisiones europeas, con estructura de artículos y referencias compatibles con CELEX.
• Resolución: Resoluciones alemanas con tribunal, número de expediente, fecha, área jurídica, sumario, historial procesal, texto completo estructurado, párrafos y enlaces de cita.
• Resolución europea: Resoluciones del TJUE y del Tribunal General con números de expediente, valores ECLI y enlaces a actos jurídicos europeos.
• Referencia: Citas y referencias de fuente como números de expediente, citas de revistas, documentos parlamentarios o referencias BGBl que conectan entidades en el grafo.
• Relación: Las relaciones conectan dos entidades en el grafo. Tienen un peso y una descripción en texto libre para que la fuerza, la relevancia y el contexto jurídico de la conexión sean explicables.
• Permalink: Todas las entidades encontradas se pueden consultar en nuestra base de datos mediante su permalink.

Inicio rápido

Empieza con el endpoint de respuesta cuando quieras que LexGraph recupere contexto jurídico y genere una respuesta en una sola llamada.

Claves API bearer

Cada request necesita un header Authorization. Las claves inválidas devuelven 401 con Invalid API key.

Formatos de respuesta

Los endpoints de búsqueda devuelven entities y count. Pon "relationships": true para incluir un array adicional relationships; "permalinks": true añade enlaces de LexGraph listos para navegador cuando puedan crearse o encontrarse.

Filtros

Todos los endpoints directos de búsqueda y POST /v1/answer aceptan el mismo objeto opcional filters. Aplica restricciones estrictas mediante metadatos almacenados en LexGraph o derivados de forma fiable de entidades enlazadas.

Esquema de filtros

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";
  };
};

Valores de filtro admitidos

Cambia entre los campos para consultar los valores canónicos de LexGraph y el formato requerido.

Áreas jurídicas

Estos son los valores canónicos utilizados en LexGraph. El campo de la API acepta strings, pero para obtener resultados fiables conviene usar uno de estos valores.

• 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

Regiones

Esta es la lista completa de regiones aceptadas por el esquema del request. Los valores deben enviarse exactamente como aparecen.

• 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

Tribunales

Usa el código normalizado y no el nombre completo del tribunal. Actualmente no se buscan tribunales europeos mientras haya filtros activos.

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

Periodo

El periodo no tiene una lista fija. von y bis aceptan una fecha de calendario inclusiva en formato ISO YYYY-MM-DD.

• Desde una fecha: { "von": "2020-01-01" }
• Hasta una fecha: { "bis": "2026-08-14" }
• Periodo cerrado: { "von": "2020-01-01", "bis": "2026-08-14" }

Reglas de combinación y validación

• Los cuatro campos son opcionales. Los campos desconocidos dentro de filters o zeitraum se rechazan con 422.
• Los valores de un mismo array usan OR. Las dimensiones no vacías aplicables a una fuente se combinan con AND.
• gerichte compara códigos normalizados como BAG, LAG o BGH; regionen acepta Bund, EU o el nombre de un estado federado alemán.
• zeitraum.von y zeitraum.bis son fechas ISO inclusivas en formato YYYY-MM-DD; von no puede ser posterior a bis.

Dimensiones aplicables por fuente

Request filtrado

{
  "query": "¿Qué resoluciones alemanas de derecho laboral del BAG desde 2020 son relevantes?",
  "filters": {
    "rechtsgebiete": [
      "Arbeitsrecht"
    ],
    "regionen": [
      "Bund",
      "Berlin"
    ],
    "gerichte": [
      "BAG",
      "LAG"
    ],
    "zeitraum": {
      "von": "2020-01-01",
      "bis": "2026-08-14"
    }
  },
  "limit": 20
}

Cobertura actual

• Una dimensión no aplicable no elimina esa fuente. Las referencias y los ejemplos sin metadatos aplicables fiables se excluyen de forma conservadora.
• Las normas de la UE y las resoluciones de tribunales europeos no se incluyen mientras haya filtros activos.
• Las normas estatales alemanas se buscan sin embeddings mediante Arango Views configuradas. Actualmente existen Views para Baden-Württemberg, Baviera, Berlín, Hamburgo, Hesse, Mecklemburgo-Pomerania Occidental, Sarre, Sajonia-Anhalt, Schleswig-Holstein y Turingia. Para los otros seis estados no se consulta actualmente ninguna View de derecho estatal; los filtros regionales de resoluciones siguen funcionando.

Límites de rate, semanales y de caracteres

Un valor de límite -1 significa ilimitado. Los endpoints de búsqueda usan contadores semanales de búsqueda; /v1/answer usa contadores semanales de respuesta.

Fuentes de datos

data_sources limita los tipos de fuente solicitados. Los valores permitidos dependen del endpoint; consulta la lista de fuentes de cada endpoint.

Graph Search busca internamente en todas las fuentes compatibles con el grafo y aplica data_sources como filtro final. limit sigue siendo un máximo, y Quality Control puede reducir aún más count.

Headers de límite

Las respuestas incluyen metadatos de rate limit. Los endpoints de búsqueda y respuesta también incluyen contadores semanales para su grupo de cuota.

• X-RateLimit-Limit: Límite de requests para la ventana actual.
• X-RateLimit-Remaining: Requests restantes en la ventana actual.
• X-RateLimit-Reset: Marca temporal en la que se reinicia la ventana.
• X-SearchLimit-*: Metadatos de la cuota semanal de búsqueda.
• X-AnswerLimit-*: Metadatos de la cuota semanal de respuestas.
• Retry-After: Segundos hasta reintentar después de 429.

Endpoints

Estos endpoints cubren generación de respuestas, extracción de referencias, validación de citas y recuperación de texto completo para resoluciones conocidas.

Errores

Las respuestas de error usan códigos HTTP estándar. Usa el código y el detalle de la respuesta para decidir si reintentar, cambiar el request o revisar credenciales.

• 401: Falta la clave API o no es válida.
• 403: La clave está desactivada, caducada o no tiene el scope requerido.
• 404: No se encontró la resolución o entidad solicitada.
• 413: text o query supera max_chars_per_request.
• 422: El esquema del request, los valores de filtro o data_sources no son válidos o compatibles.
• 429: Se superó el límite de rate, caracteres, búsqueda o respuestas.
• 503: El backend de extracción de referencias o generación de respuestas no está disponible.