API score de défaillance en lot : classer ses clients par risque

GET/v1/score/defaillance/lot

Prix: 0,07 € / entité
Quota gratuit: Non
Famille: France · finances et risque

Paramètres
Paramètre	Où	Exemple
`sirens`	requête · obligatoire	`000000042,000000075`

Ce qui est facturé

200Réponse signée Ed25519, débitée au prix de la route
402Devis x402 signé, rien n'est débité
4xxIdentifiant inconnu ou invalide, jamais facturé
5xxSource amont indisponible, jamais facturé

Voir une réponse sur données de test (gratuit) Obtenir le devis de /v1/score/defaillance/lot

curlx402MCPPythonJS

curl "https://api.sirenic.eu/v1/score/defaillance/lot?sirens=000000042,000000075" \
  -H "X-Api-Key: $SIRENIC_KEY"

# 1. Le devis, sans rien payer : la route répond 402 avec son montant
curl -i "https://api.sirenic.eu/v1/score/defaillance/lot?sirens=000000042,000000075"

# 2. L'appel réglé : le client x402 paie le devis et rejoue la requête
npx x402-fetch "https://api.sirenic.eu/v1/score/defaillance/lot?sirens=000000042,000000075"

# Ou en MCP, dans Claude Code / Cursor / un agent
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

# Ou en serveur local (stdio), avec votre clé ou un portefeuille x402
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp

import os, requests

r = requests.get(
    "https://api.sirenic.eu/v1/score/defaillance/lot?sirens=000000042,000000075",
    headers={"X-Api-Key": os.environ["SIRENIC_KEY"]},
)
print(r.json())

const r = await fetch("https://api.sirenic.eu/v1/score/defaillance/lot?sirens=000000042,000000075", {
  headers: { "X-Api-Key": process.env.SIRENIC_KEY },
});
console.log(await r.json());

200 OK · extrait

{
 "nombre_demande": 2,
 "nombre_trouve": 2,
 "paniers": {
  "expose": 1,
  "a_surveiller": 0,
  "sain": 0,
  "non_evaluable": 1,
  "cessee": 0
 },
 "groupes": {
  "expose": [
   {
    "jeu_axes": 0,
    "effectif": 1
   }
  ],
  "non_evaluable": [
   {
    "jeu_axes": 1,
    "effectif": 1
   }
  ]
 },
 "jeux_axes": [
  [
   "structure",
   "rentabilite",
   "liquidite",
   "dette",
   "anciennete",
   "etat",
   "bodacc"
  ],
  [
   "anciennete",
   "etat",
   "bodacc"
  ]
 ],
 "lignes": [
  {
   "trouve": true,
   "siren": "000000042",
   "denomination": "SOCIETE FICTIVE DELTA",
   "panier": "expose",
   "classe": "risque_eleve",
   "score_risque": 66,
   "confiance": "forte",
   "jeu_axes": 0,
   "axes_calcules": 7,
   "motifs_principaux": [
    "rentabilite",
    "structure",
    "liquidite"
   ],
   "signaux_bodacc": {
    "procedure_collective": false,
    "liquidation_judiciaire": false,
    "cloture_insuffisance_actif": false
   },
   "version_modele": "defaillance-v1.9"
  },
  {
   "trouve": true,
   "siren": "000000075",
   "denomination": "SOCIETE FICTIVE ETA",
   "panier": "non_evaluable",
   "classe": "indetermine",
   "score_risque": 0,
   "confiance": "faible",
   "jeu_axes": 1,
   "axes_calcules": 3,
   "motifs_principaux": [],
   "cause": "aucun_exercice"
  }
 ],
 "chainage": {
  "surveillance": {
   "route": "GET /v1/surveillance/creer",
   "parametres": {
    "cibles": "000000042",
    "duree": 30
   },
   "nombre_cibles": 1,
   "devis_30_jours": "$0.05",
   "prix_unitaire_30_jours": "$0.05",
   "au_dela_du_plafond_client": false
  }
 }
}

Photo datée du 06/10/2026, rendue par la route sur des données de test (entreprises fictives), sans achat, tronquée à un élément par tableau. Ce n'est pas une donnée en direct. L'extrait complet est servi gratuitement par la surface d'exemples, et le schéma par l'OpenAPI.

Réponse complète (données de test) ↗

Ce que la route rend

Description publiée au catalogue, traduite ici en français (les agents la lisent en anglais, comme toutes nos surfaces de découverte) :

Notation du risque de crédit en lot de 2 à 100 entreprises françaises (sirens séparés par des virgules) : chaque ligne a le score, la classe et la version de modèle de GET /v1/score/defaillance/{siren} et un panier en liste fermée (expose, a_surveiller, sain, non_evaluable avec sa cause, cessee). Classe mes clients par risque et surveille les 30 plus exposés : chainage.surveillance liste tout le panier expose, rangé (100 au plus), avec son devis de 30 jours, cibles x prix unitaire ; gardez-en les 30 premiers. 0,07 € par SIREN, SIREN inconnu compris.

Identifiant attendu

Paramètre sirens : de 2 à 100 SIREN séparés par des virgules.

Un identifiant au mauvais format dans le chemin rend 400 et n'est pas facturé — mais il vous fait perdre un aller-retour. C'est la première cause d'appel raté sur les routes étrangères. Un paramètre de recherche, lui, est nettoyé : les caractères non pris en charge sont retirés et la requête utile est servie.

Prix et facturation

Tarif : 0,07 € / entité, débité en crédits (1 crédit = 1 €) ; en x402, le même montant se règle en USDC ou en EURC. Le montant qui fait foi est celui du devis 402 renvoyé par la route elle-même, pas ce texte, qui est dérivé de la même grille mais reste une page.

Facturation par lot : le paramètre sirens accepte de 2 à 100 valeurs séparées par des virgules, et le montant est le prix unitaire multiplié par le nombre de valeurs. Le devis est figé avant règlement : il n'y a pas de règlement partiel.

Une réponse d'erreur annule le paiement : un 400, un 404 ou un 503 n'est jamais facturé. Une panne d'une source amont ferme la route en 503 plutôt que de servir une réponse dégradée.

Ce que cette route ne fait pas

Sur un fichier quelconque de personnes morales, la plupart des lignes sont non évaluables faute de comptes publiés (mesuré le 03/10/2026 : 86 % des personnes morales actives, 71,5 % des sociétés commerciales) ; elles sont facturées avec leur cause. La surveillance proposée est quotidienne, jamais en temps réel.

Routes voisines

/v1/score/defaillance/{siren} — 0,10 €
/v1/surveillance/creer — 0,05 € (30 j) · 0,135 € (90 j) · 0,50 € (365 j) / entité
/v1/kyb/batch — 0,105 € / entité

Comment on paie

Chaque route se paie à l'appel, en USDC ou EURC sur le réseau Base, par le protocole x402 : pas de compte à créer, pas de clé d'API, pas d'abonnement. Le premier appel renvoie un devis 402 que votre client règle, puis rejoue l'appel. Un appel en erreur n'est jamais facturé.

Ouvert aujourd'hui : 150 appels gratuits par mois avec un compte, sur 106 routes sur 122 (la grille dit lesquelles), et le paiement à l'appel en x402 (USDC ou EURC), sans compte sauf les actes du registre. Crédits prépayés : leur recharge par carte n'est pas encore ouverte.

Les réponses payantes sont signées Ed25519 : vous pouvez prouver plus tard ce qui vous a été servi, et à quelle date. Le catalogue entier est lisible gratuitement dans l'OpenAPI et le llms.txt.

Un appel, de bout en bout

# Client x402 (npm) : le devis 402 est réglé et l'appel rejoué automatiquement
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Ou en MCP, dans Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

# Ou en serveur local (stdio), avec votre clé ou un portefeuille x402
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp

Routes utilisées et prix

Route	Prix	Exemple	Ce qu'elle rend
`/v1/score/defaillance/lot`	0,07 € / entité	exemple gratuit	Notation du risque de crédit en lot de 2 à 100 entreprises françaises (sirens séparés par des virgules) : chaque ligne a le score, la classe et la version de modèle de GET /v1/score/defaillance/{siren} et un panier en liste fermée (expose, a_surveiller, sain, non_evaluable avec sa cause, cessee). Classe mes clients par risque et surveille les 30 plus exposés : chainage.surveillance liste tout le panier expose, rangé (100 au plus), avec son devis de 30 jours, cibles x prix unitaire ; gardez-en les 30 premiers. 0,07 € par SIREN, SIREN inconnu compris.

Le score de défaillance est un indicateur d'aide à la décision. Ce n'est ni un avis de solvabilité, ni une notation de crédit au sens réglementaire, et il ne garantit aucun paiement.

Passer à l'action

Aucun compte à créer, aucune clé à demander : la première étape est gratuite et vous montre exactement ce que vous achèteriez.

Voir une réponse sur données de test (gratuit) Obtenir le devis de /v1/score/defaillance/lot Créer un compte : 150 appels gratuits par mois

Score de défaillance en lot, par panier