Documentation API

Intégrez la détection de risque Vigia dans votre application

Une API REST simple pour accéder aux scores de risque, alertes et watchlists — en quelques lignes de code.

REST JSON·Format standard
Auth Bearer·Clé API sécurisée
HTTPS·api.vigia.io
Sandbox·Disponible sur demande

Authentification

Toutes les requêtes nécessitent une clé API

Ajoutez votre clé dans l'en-tête Authorization de chaque requête.

En-tête requis

Authorization: Bearer sk_vigia_xxxxxxxxxxxxxxxxxxxx

Endpoints

Quatre endpoints pour tout faire

Accédez aux scores, alertes et watchlists avec une API REST simple et prévisible. Toutes les réponses sont en JSON.

GET/v1/company/{siren}

Score de risque d'une entreprise

Requête

curl -H "Authorization: Bearer sk_vigia_..." \
  https://api.vigia.io/v1/company/552032534

Réponse

{
  "siren": "552032534",
  "name": "TOTAL ENERGIES SE",
  "risk_score": 12,
  "risk_level": "low",
  "last_updated": "2026-04-15T08:32:00Z",
  "signals": {
    "financial_health": "stable",
    "legal_events": 0,
    "payment_behavior": "good"
  }
}
GET/v1/company/{siren}/alerts

Alertes récentes sur une entreprise

Requête

curl -H "Authorization: Bearer sk_vigia_..." \
  https://api.vigia.io/v1/company/552032534/alerts

Réponse

{
  "siren": "552032534",
  "alerts": [
    {
      "id": "alt_8f2a1c",
      "type": "legal_filing",
      "severity": "medium",
      "message": "Dépôt de comptes annuels en retard de 4 mois",
      "detected_at": "2026-04-10T14:22:00Z"
    }
  ],
  "total": 1
}
POST/v1/watchlist

Ajouter des entreprises à surveiller

Requête

curl -X POST \
  -H "Authorization: Bearer sk_vigia_..." \
  -H "Content-Type: application/json" \
  -d '{"sirens":["552032534","542051180"]}' \
  https://api.vigia.io/v1/watchlist

Réponse

{
  "watchlist_id": "wl_7g3k9m",
  "added": ["552032534", "542051180"],
  "total_companies": 47
}
GET/v1/watchlist/alerts

Flux d'alertes de votre watchlist

Requête

curl -H "Authorization: Bearer sk_vigia_..." \
  "https://api.vigia.io/v1/watchlist/alerts?limit=10"

Réponse

{
  "alerts": [
    {
      "id": "alt_9c3d2f",
      "siren": "542051180",
      "company": "CARREFOUR SA",
      "type": "score_change",
      "severity": "high",
      "message": "Score de risque dégradé de 28 → 67",
      "detected_at": "2026-04-14T09:15:00Z"
    }
  ],
  "total": 1,
  "page": 1
}

Cas d'intégration

Adapté à votre stack

L'API Vigia s'intègre dans les outils que vos équipes utilisent déjà, quel que soit votre secteur.

Fintech

Évaluez la solidité de vos contreparties avant chaque opération de crédit ou d'investissement.

ERP / Finance

Synchronisez automatiquement les scores de risque dans votre ERP pour enrichir le suivi fournisseur.

CRM

Ajoutez une couche de risque dans votre CRM pour que les équipes commerciales voient les signaux d'alerte client.

Supply Chain

Surveillez vos fournisseurs critiques en continu et recevez des alertes avant les ruptures.

Commencer

Prêt à intégrer Vigia ?

Obtenez votre clé API et accédez à la sandbox en moins de 24h.

Demander votre clé API

Une question ? contact@vigia.nanocorp.app