← API Dirigeants

Documentation — API Dirigeants

Vérifiez en un appel si les dirigeants d'une ou plusieurs entreprises (par SIREN) sont toujours en activité ou décédés, à partir du Registre National des Entreprises (RNE) croisé avec le registre INSEE des décès.

Base URL

https://api.dataroia.com/api/v1

Authentification

Toutes les requêtes nécessitent une clé API dans l'en-tête X-API-Key. Contactez contact@dataroia.com pour obtenir une clé.

X-API-Key: droia_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Endpoint

POST /dirigeants/check

Retourne la liste des dirigeants actifs pour chaque SIREN fourni, avec leur statut vital.

Body
{ "sirens": ["987654324", "912345675"] }
ChampTypeDescription
sirensstring[]Liste de SIREN (9 chiffres). Le nombre maximum par appel dépend de votre plan.
Réponse 200
{ "results": { "987654324": [ { "type": "ei", "nom": "DURAND", "prenoms": "MARIE", "denomination": null, "siren_dirigeant": null, "role": "Entrepreneur individuel", "annee_naissance": null, "decede": false, "statut_vital": "vivant", "date_deces": null, "score": 0.0 } ], "912345675": [ { "type": "ei", "nom": "MARTIN", "prenoms": "JEAN PIERRE", "denomination": null, "siren_dirigeant": null, "role": "Entrepreneur individuel", "annee_naissance": null, "decede": true, "statut_vital": "decede_certain", "date_deces": "2021-03-14", "score": 0.98 } ] } }
Champs de la réponse
ChampDescription
typeindividu (dirigeant personne physique), ei (entrepreneur individuel) ou entreprise (dirigeant personne morale)
nom, prenomsIdentité du dirigeant (personnes physiques)
denomination, siren_dirigeantIdentité du dirigeant si personne morale
roleFonction (gérant, président, entrepreneur individuel, etc.)
annee_naissanceAnnée de naissance, si connue
decedetrue si décès certain ou probable
statut_vitalvivant, decede_certain, decede_probable ou inconnu (toujours inconnu pour les dirigeants personnes morales)
date_decesDate de décès si connue
scoreIndice de confiance du croisement décès (0.0 à 1.0)

Un SIREN sans dirigeant trouvé dans le RNE renvoie une liste vide [].

Erreurs

CodeCause
401Clé API manquante ou invalide
422SIREN invalide, liste vide, ou nombre de SIREN supérieur à la limite de votre plan
500Erreur interne

Plans & quotas

PlanQuota mensuel (SIREN traités)Max SIREN / appel
Free3 0001
Starter5 00010
Business30 00020
ScaleSur devis20

Le quota mensuel est informatif : il n'y a pas de coupure en cas de dépassement, le dépassement est facturé séparément selon votre contrat.

Exemples

curl
curl -X POST https://api.dataroia.com/api/v1/dirigeants/check \ -H "X-API-Key: droia_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"sirens": ["987654324", "912345675"]}'
Python
import requests r = requests.post( "https://api.dataroia.com/api/v1/dirigeants/check", headers={"X-API-Key": "droia_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"}, json={"sirens": ["987654324", "912345675"]}, ) r.raise_for_status() print(r.json())