← 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"]
}

Champ	Type	Description
`sirens`	string[]	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

Champ	Description
`type`	`individu` (dirigeant personne physique), `ei` (entrepreneur individuel) ou `entreprise` (dirigeant personne morale)
`nom`, `prenoms`	Identité du dirigeant (personnes physiques)
`denomination`, `siren_dirigeant`	Identité du dirigeant si personne morale
`role`	Fonction (gérant, président, entrepreneur individuel, etc.)
`annee_naissance`	Année de naissance, si connue
`decede`	`true` si décès certain ou probable
`statut_vital`	`vivant`, `decede_certain`, `decede_probable` ou `inconnu` (toujours `inconnu` pour les dirigeants personnes morales)
`date_deces`	Date de décès si connue
`score`	Indice de confiance du croisement décès (0.0 à 1.0)

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

Erreurs

Code	Cause
`401`	Clé API manquante ou invalide
`422`	SIREN invalide, liste vide, ou nombre de SIREN supérieur à la limite de votre plan
`429`	Quota journalier atteint, ou quota mensuel épuisé sans crédits prépayés suffisants
`500`	Erreur interne

Plans & quotas

Plan	Prix / mois	Quota mensuel (SIREN traités)	Appels pleins / jour	Max SIREN / appel
Free	0 €	250	10	5
Solo	9 €	500	50	10
Starter	49 €	3 000	500	10
Business	199 €	30 000	5 000	20
Enterprise	Sur devis	Illimité	Illimité	50

Tous les plans, plan gratuit compris, accèdent à l'ensemble des services : ils ne diffèrent que par leurs quotas. Le quota mensuel est appliqué : une fois épuisé, les appels basculent sur vos crédits prépayés, et renvoient 429 si le solde est insuffisant.

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())