← 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
`500`	Erreur interne

Plans & quotas

Plan	Quota mensuel (SIREN traités)	Max SIREN / appel
Free	3 000	1
Starter	5 000	10
Business	30 000	20
Scale	Sur devis	20

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