La jurisprudence des juridictions supérieures directement dans votre code
Recherche sémantique dans la jurisprudence des juridictions supérieures en tant qu’outil externe. Se connecte à votre application reposant sur n’importe quel LLM ou à n’importe quel client HTTP. Une requête renvoie des décisions réelles avec leurs références, leurs citations et des liens vers le texte intégral.
L’accès promotionnel (300 requêtes pendant 10 jours) est terminé 27 juin 2026. Les nouvelles clés ne sont actuellement plus délivrées automatiquement et aucun forfait API payant n’est encore disponible. Les conditions ci-dessous décrivent l’offre promotionnelle et sont conservées à titre informatif : nous ouvrons l’accès manuellement — écrivez à l’administrateur dans @CasusLegalBot ou dans la rubrique « Messages » de l’espace personnel. La documentation et les exemples de code sont à jour.
En bref : ce que le connecteur sait déjà faire dans votre Claude, ChatGPT, Grok ou Hermes peut désormais être intégré à votre propre produit.
Une clé API est une longue chaîne secrète qui commence par cl_live_ (par exemple, cl_live_QZbj…). Vous l’insérez dans votre code ; elle permet à votre serveur ou à votre application d’accéder à la jurisprudence de la Cour constitutionnelle, de la Cour suprême et de la Cour suprême d’arbitrage (arbitrazh) de Russie. Il s’agit d’environ 27 000 décisions originales depuis 1992 jusqu’à aujourd’hui.
Vous envoyez une requête HTTP ordinaire et recevez en réponse de véritables décisions : références, citations textuelles et liens vers le texte intégral. Aucune décision inventée.
La clé n’est affichée qu’une seule fois lors de sa création ; enregistrez-la donc immédiatement. Nous ne conservons que le hachage de la clé : il est impossible de récupérer la clé elle-même. Conservez-la sur votre serveur ; ne l’intégrez pas à un site web, à une application mobile ou à un dépôt public. Si la clé a fuité, révoquez-la dans votre espace personnel et rendez-vous dans la rubrique « Messages » pour convenir de son remplacement.
Pendant la promotion, une limite gratuite unique s’appliquait. L’offre a pris fin le 27 juin 2026 — les chiffres ci-dessous sont conservés à titre informatif.
L’API obéit à des conditions d’accès distinctes. Les forfaits de requêtes du bot et du chat web ne donnent pas accès à l’API. Les forfaits API payants ne sont actuellement pas commercialisés ; la possibilité d’accès et les limites sont convenues manuellement via la rubrique « Messages » de l’espace personnel.
Les fonds de l’offre promotionnelle ne sont pas utilisés, mais le solde de 300 requêtes est décompté comme suit.
Une requête n’est décomptée que si elle a abouti : en cas d’erreur de notre côté ou de solde épuisé, rien n’est « consommé ». Une limitation souple de la vitesse, d’environ 20 requêtes par minute, s’applique : elle ne débite pas le solde, mais lisse les pics.
Pour que les choses soient claires et sereines.
Le client saisit sa question et voit une sélection de décisions réelles avec des liens. La recherche fonctionne par le sens ; elle convient donc aussi aux non-juristes.
Le bot répond non pas « de mémoire », mais avec des liens vers des affaires précises. Il élimine le principal problème : les décisions inventées.
Récupérez le texte intégral des décisions en Markdown comme contexte pour des avis, des projets de documents ou des réponses.
Vous trouvez les décisions, exportez la sélection en DOCX et l’insérez dans une demande en justice, des conclusions ou un mémorandum. Les heures de copie manuelle disparaissent.
Requêtes groupées par thèmes, normes et années, statistiques du corpus, suivi régulier des positions récentes des collèges.
La jurisprudence dans la base de connaissances, le CRM du service juridique ou le système de validation des contrats, directement là où le travail est effectué.
Connexion, endpoints, gestion des erreurs et configuration de votre LLM. Corpus : Cour constitutionnelle de la Fédération de Russie (1992–2026), Cour suprême de la Fédération de Russie (2014–2026), Cour suprême d’arbitrage (arbitrazh) de la Fédération de Russie (1992–2014), environ 27 000 décisions originales.
Il s’agit d’une REST API. Elle se connecte à votre application reposant sur n’importe quel LLM ou à n’importe quel client HTTP en tant qu’outil externe que votre modèle appelle pour effectuer des recherches dans la jurisprudence.
Base URL: https://lk.casus.legal
Authentification : en-tête Authorization: Bearer cl_live_…
Format : JSON sur HTTPS.
Adresse https://mcp.casus.legal/one/mcp — il s’agit d’un connecteur MCP distinct destiné aux assistants d’IA (Claude, ChatGPT, Grok, Hermes). Il n’a aucun rapport avec la REST API ni avec les clés cl_live_ .
cl_live_… enregistrez-la immédiatement : elle ne peut pas être récupérée. L’achat d’un forfait de chat n’ouvre pas l’accès à l’API.Les clés existantes et leurs compteurs sont visibles dans la rubrique « API » de l’espace personnel. La seule présence d’une clé ne signifie pas que l’accès est actif. Convenez du renouvellement et du remplacement de la clé par l’intermédiaire de la rubrique « Messages » ; la révocation d’une clé ne permet pas d’en émettre une nouvelle de manière autonome.
curl -X POST https://lk.casus.legal/v1/search \
-H "Authorization: Bearer $CASUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "договор энергоснабжения, фактическое потребление", "limit": 15}'
import os, httpx
client = httpx.Client(
base_url="https://lk.casus.legal",
headers={"Authorization": f"Bearer {os.environ['CASUS_API_KEY']}"},
timeout=60,
)
r = client.post("/v1/search", json={
"query": "снижение неустойки по статье 333 ГК",
"limit": 15,
"mode": "hybrid",
})
r.raise_for_status()
data = r.json()
for hit in data["results"]:
print(hit["court"], hit["date"], hit["case_number"], hit["url"])
Recherche hybride. Décompte d’une seule requête en cas de réponse positive.
| Champ | Type | Par défaut | Description |
|---|---|---|---|
query | string | obligatoire | Requête en russe. Une valeur vide renvoie 400. |
limit | int 1–30 | 10 | Taille des résultats. Pour une vue d’ensemble, il est recommandé d’utiliser 15–20. |
mode | hybrid / bm25 / semantic | hybrid | hybrid (BM25 et sémantique) est recommandé. |
court | string | – | Filtre : Cour constitutionnelle / Cour suprême / Cour suprême d’arbitrage (arbitrazh) / Collège judiciaire des litiges économiques / Collège judiciaire des affaires civiles / Plénum / vue d’ensemble. |
act_type, tag, article | string | – | Filtres supplémentaires (article, par ex. art. 333 du Code civil de la Fédération de Russie). |
year_from, year_to | int | – | Plage d’années. |
deduplicate | bool | true | Regrouper les itérations d’une même affaire. |
expand | bool | true | Élargissement de la requête par des synonymes. |
La structure de la réponse fournit des blocs prêts à l’emploi selon la hiérarchie des juridictions. Composez la réponse à partir de ces blocs, sans effectuer une requête distincte pour chaque juridiction.
{
"_response_format_hint": "…директива формата ответа…",
"constitutional_context": { "items": [ … ] }, // КС
"vs_guidance": { "items": [ … ] }, // Пленумы и обзоры ВС
"latest_practice": { "items": [ … ] }, // свежие определения коллегий ВС
"vas_history": [ … ], // история: практика ВАС
"results": [
{
"id": 12345, "court": "СКЭС", "date": "10.05.2024",
"case_number": "305-ЭС24-12345", "title": "…", "snippet": "…",
"score": 0.87,
"url": "https://lk.casus.legal/case/12345?t=<токен>"
}
],
"_supersession_alert": "…", // при наличии отменённого и действующего акта
"expansion": { … }
}
Dans le champ url de chaque acte figure un lien prêt à l’emploi vers le texte intégral, avec un jeton d’accès ?t=…. Utilisez-le tel quel : ne construisez pas le lien à partir de id et ne supprimez pas le jeton.
Fiche de l’acte : références, sections (texte par sections), articles, hashtags et liens url / url_md / url_docx. Utilisez-les pour les citations littérales des actes clés. Ne consomme pas de quota.
curl https://lk.casus.legal/v1/cases/12345 \ -H "Authorization: Bearer $CASUS_API_KEY"
Toutes les erreurs sont renvoyées au format JSON {"error": "<код>", "message": "…"}.
| HTTP | error | Quand | Que faire |
|---|---|---|---|
| 400 | bad_request | Aucun query ou JSON mal formé | Corriger le corps de la requête |
| 401 | unauthorized | Clé absente, incorrecte ou révoquée | Vérifier l’en-tête et la clé |
| 402 | quota_exhausted | Accès promotionnel expiré (dans le corps reason, message, contact_url) | Écrire à l’administrateur dans @CasusLegalBot pour le renouvellement |
| 403 | forbidden | La clé n’a pas accès à la recherche | Convenir de l’accès par la rubrique « Messages » de l’espace personnel |
| 404 | not_found | Acte comportant ce id introuvable | – |
| 429 | rate_limited | Limite de requêtes par minute dépassée | Backoff exponentiel |
| 500 | internal_error | Défaillance de notre côté | Réessayer avec backoff ; la requête n’est pas décomptée |
| 503 | engine_not_ready | Redéploiement ou préchauffage de l’index | Réessayer dans 1–3 min |
POST /v1/search décompte d’une seule requête uniquement en cas de réponse 200 : les erreurs ne sont pas facturées. GET /v1/cases/{id} est gratuit. La limite de requêtes par minute est calculée par clé (20 par minute pendant la période d’essai). Le quota restant est visible dans la rubrique « API » de l’espace personnel.
429 et 5xx réessayez en augmentant le délai : 2 s, 4 s, 8 s.GET /v1/cases/{id} reste stable et l’appel est gratuit.url est signé par un jeton valable environ 30 jours. Transmettez-le tel quel.L’API fournit les données brutes : fiches d’actes, blocs thématiques et indication de format _response_format_hint. La qualité de la réponse finale est déterminée par l’instruction système de votre LLM. Vous trouverez ci-dessous les principes applicables à deux scénarios, et non des prompts prêts à l’emploi.
/v1/search avec une requête pertinente et limit 15–20 : la hiérarchie des juridictions est déjà fournie par blocs. Ne divisez pas le sujet en requêtes pour chaque juridiction._response_format_hint. Il s’agit d’une directive de format intégrée ; sa prise en compte rapproche sensiblement la réponse d’une vue d’ensemble de référence.url. Interdisez de construire l’adresse à partir de id et de supprimer le jeton ?t= : sans lui, le lien n’ouvrira pas le texte./v1/cases/{id} uniquement pour 3–5 actes clés. Pour la Cour constitutionnelle, la citation nécessaire figure déjà dans le champ inline position. C’est la principale source de jetons superflus.Objectif : une sélection ou une liste d’affaires à exporter, sans analyse juridique.
court / act_type / tag / article / year_from–year_to : le catalogue sera pertinent et compact.id, les références (juridiction, type, date, numéro d’affaire) et url. Dans ce mode, ne résumez pas et ne citez pas les actes./v1/search par sous-thème, année ou juridiction, puis regroupez les résultats en supprimant les doublons selon id.url, que l’utilisateur filtrera lui-même.