API RiskSonnar

La due diligence dans votre stack : un appel REST, un score 0-100, une décision recommandée et le rapport complet. Disponible sur le plan Business (650 scans/mois inclus, clé API depuis le dashboard).

Authentification

Chaque requête porte votre clé API dans l'en-tête X-API-Key. La clé se génère et se révoque depuis votre dashboard (plan Business requis).

Lancer un scan

# Analyse complète d'une entreprise (~60 s)
curl -X POST https://www.risksonnar.com/api/v1/scan \
  -H "X-API-Key: rsk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"company_name": "Acme SAS", "country": "FR"}'

# Réponse (extrait)
{
  "analysis_id": "8c2f…",
  "score_global": 82,
  "niveau_risque": "FAIBLE",
  "rating": {"grade": "A"},
  "decision": {"action": "APPROUVER"},
  "unified_decision": {"plafond_display": "100 000 €", "delai_paiement": "90 jours fin de mois"},
  "metadata": {"data_freshness": {"sanctions": "2026-06-11", "pep": "2026-06-11"}}
}

Décision pre-onboarding (go / review / no-go)

Pour brancher RiskSonnar avant la création du fournisseur dans votre ERP ou outil achats : même moteur que le scan, mais la réponse est une décision actionnable par un système — un mot, les raisons, vos seuils, l'échéance de re-certification. Une entité sanctionnée est toujours rejetée, quels que soient vos seuils.

curl -X POST https://www.risksonnar.com/api/v1/decision \
  -H "X-API-Key: rsk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"company_name": "Acme SAS", "country": "FR",
       "ref": "PO-2026-114",
       "policy": {"reject_below": 50, "review_below": 80}}'

# Réponse (extrait)
{
  "decision": "review",
  "ref": "PO-2026-114",
  "score": 72,
  "niveau_risque": "MODERE",
  "rationale": "Score 72 sous le seuil d'approbation (80).",
  "reasons": ["Capitaux propres en baisse sur 2 exercices", "…"],
  "conditions": ["Limite d'encours réduite pendant les 90 premiers jours", "…"],
  "policy_applied": {"reject_below": 50, "review_below": 80, "sanctions_hard_block": true},
  "valid_until": "2027-06-12T…",
  "report_url": "https://www.risksonnar.com/verify/8c2f…"
}

Récupérer une analyse / le PDF

curl https://www.risksonnar.com/api/v1/analysis/{analysis_id} \
  -H "X-API-Key: rsk_live_..."

curl -OJ https://www.risksonnar.com/api/report/{analysis_id}/pdf

Webhooks

Abonnez votre système aux événements — chaque livraison est signée HMAC-SHA256 (en-tête X-RiskSonnar-Signature). Sans code : recettes Zapier, Make et n8n prêtes à l'emploi sur /integrations.

ÉvénementDéclencheur
scan.completedUne analyse se termine
score.changedLe score d'une entité surveillée bouge au-delà du seuil
sanction.detectedNouveau hit sanctions sur une entité surveillée
procedure.openedNouvelle procédure collective (BODACC)
bulk_scan.completedUn scan CSV en masse se termine
# S'abonner
curl -X POST https://www.risksonnar.com/api/webhooks \
  -H "X-API-Key: rsk_live_..." \
  -d '{"url": "https://votre-si.example/hooks/risksonnar", "events": ["scan.completed", "sanction.detected"]}'

Scan en masse

JSON (API) — jusqu'à 20 entités par appel :

curl -X POST https://www.risksonnar.com/api/v1/scan-batch \
  -H "X-API-Key: rsk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"names": [{"company_name": "Acme SAS", "country": "FR"},
                 {"company_name": "Atlas Travaux", "country": "MA"}]}'

# 202 → {"job_id": "...", "status_url": "/api/v1/scan-batch/{job_id}"}
# Pollez le status_url (30-60 s/entité) ou abonnez bulk_scan.completed ;
# chaque ligne devient une analyse normale (/api/v1/analysis/{id}).

CSV (UI/upload) — jusqu'à plusieurs milliers d'entités par fichier : POST /api/bulk-scan/upload (multipart), suivi par GET /api/bulk-scan/{job_id}/status, résultat CSV en GET /api/bulk-scan/{job_id}/result.

📚 La référence complète et interactive (tous les endpoints, schémas, codes d'erreur) est sur /docs (OpenAPI/Swagger) — essayez les appels directement depuis le navigateur.

Data-service partenaires (screening en marque blanche)

Éditeur de logiciel, fintech, RegTech ? Le data-service expose nos données en service-à-service : screening batch sanctions multi-listes + PEP (POST /api/v1/datasvc/screening, jusqu'à 100 noms/appel), résolution de sociétés FR/MA (GET /api/v1/datasvc/search) et fiches avec dirigeants et drapeaux pré-calculés (GET /api/v1/datasvc/entity/{country}/{id}). Authentification par clé de service dédiée, fraîcheur des sources exposée par GET /api/v1/datasvc/meta. Contactez-nous pour une clé d'évaluation.

Limites & bonnes pratiques

Demander un accès API →