Liens capitalistiques Version beta

Actionnaires et filiales de l'entreprise déclarés dans les CERFA 2059F et 2059G des liasses fiscales de la DGFIP.

Cette API est en bêta test

Elle est en production et fonctionnelle, mais succeptible de changer en fonction des retours des utilisateurs et du fournisseur de données.

Vous serez bien entendu informé des changements en amont le cas échéant. N'hésitez pas à contacter le support si vous avez des questions.

Logo du fournisseur de données
Fournisseur de la donnée

DGFIP


Périmètre

Entreprises ou associations concernées :

Cette API délivre liens capitalistiques des entreprises :

  • ✅ soumises à l’impôt sur les sociétés (IS)* ;
  • ✅ soumises à l’impôt sur les sociétés dû par le groupe (IS GROUPE)*;
  • ✅ aux bénéfices industriels et commerciaux (BIC)* ;
  • ✅ aux bénéfices non commerciaux (BNC)* ;
  • ✅ aux bénéfices agricoles (BA)*.

*selon les règles des régimes réels, normal ou simplifié.

Les entreprises aux régimes micro-BIC, micro-BNC et micro-BA (micro-entrepreneurs) ne sont pas concernées par cette API. En effet, elles ne déposent pas de déclarations de résultat mais des éléments spécifiques dans la déclaration 2042C qui relève de l’impôt sur le revenu.

Actualisation de la donnée :

Les données issues des liasses fiscales (dont 2059F/G) sont disponibles à compter du lendemain de la date de dépôt (J+1) et trois jours plus tard (J+3) si le dépôt intervient la veille d’un week-end.

La date limite de dépôt des liasses fiscales est fixée chaque année au 2e jour ouvré suivant le 1er mai pour les entreprises qui clôturent au 31 décembre.

En cas d’exercice à cheval, la date limite de dépôt est positionnée trois mois après la date de clôture de l’exercice.

Cas d'usage

Liste des cas d'usage où cette API est utile :
Liste des cas d'usage où cette API est peut être utile :

Détails de l'API

Format de l'information

Donnée structurée JSON

Identifiants d'appel

Numéro de SIREN de l'entreprise
Année (fiscale) correspondant à l’exercice visé

Disponibilité

Temps réel :
Page de statut des API
En maintenance tous les jours de 01:00 à 02:00

Spécifications techniques :

Consulter le swagger Cas de tests

Les données

Cette API permet de récupérer la composition du capital (liste des actionnaires, pourcentage de détention, type de personne, adresses, etc.) et la liste des participations (filiales détenues par l’entreprise).

Les données transmises sont déclaratives et proviennent de deux CERFA des liasses fiscales déposées auprès de la DGFIP :

  • CERFA 2059F : Composition du capital social (actionnaires, répartition, etc.)
  • CERFA 2059G : Participations (filiales et leurs adresses).

Liste exhaustive des codes nref renvoyés par l’API.

Des données déclaratives parfois imprécises :
Les données sont soumises à la saisie déclarative des entreprises et peuvent contenir des anomalies :

  • Des adresses parfois erronnées ou non formatées pour les personnes physiques (codes nref 304875, 304876, 304877) ;
  • Le nombre d’actionnaires, d’actions ou de filiales indiqué peut ne pas correspondre exactement aux éléments listés (en cas d’erreur de déclaration) ;
  • Les données non numériques ou en pourcentage sont renvoyées « en l’état » (telles que saisies par l’entreprise), potentiellement sujettes à erreurs ou incohérences ;
  • Les entreprises étrangères indiquent parfois des Siren « fictifs » (ex. 99999999).
  • Le dictionnaire officiel TDFC peut faire référence à des numéros SIRET, mais en pratique il s’agit plutôt de numéros SIREN déclarés par l’entreprise.

Pour plus de données, utiliser l’API Liasses fiscales :
Les informations de naissance des personnes physiques ne sont pas présentes dans cet endpoint mais figurent dans l’API Liasses fiscales qui propose des données plus exhaustives.
L’absence de ces deux imprimés, indiquée par un code erreur 404, ne signifie pas nécessairement que l’ensemble des liasses fiscales est manquant, mais simplement que ces deux CERFA (2059F/G) n’ont pas été retrouvés pour ce SIREN sur l’exercice demandé.

Informations renvoyées en JSON :

Composition du capital social
Informations extraites du CERFA 2059F (nref: 2059F). Si la liasse est absente, l'ensemble des valeurs sont à null
Liste des actionnaires
Liste des actionnaires avec une structure normalisée (nref: structure standardisée issue du serializer)
Cette propriété contient 1 ou plusieurs éléments ayant les spécifications suivantes :
Type d'actionnaire
Type de l'actionnaire, 'personne_morale' ou 'personne_physique' (nref: valeur fixe)
Pourcentage de détention
ex: 51.0
Pourcentage de détention de l'actionnaire (nref: 304861 pour personne morale, 304871 pour personne physique)
Nombre de parts
ex: 510
Nombre de parts détenues par l'actionnaire (nref: 304860 pour personne morale, 304870 pour personne physique)
Attributs de la personne physique
Attributs spécifiques pour une personne physique. Si l'actionnaire n'est pas de type 'personne_physique', tous les champs seront null (nref: 306874, 304868, 304869, 304878, 905900, 905901, 905902)
Civilité
ex: M
Civilité de la personne physique (nref: 306874)
Nom patronymique et prénoms
ex: CHIRAC Jacques
Nom patronymique et prénoms (nref: 304868)
Nom marital
ex: NS
Nom marital (nref: 304869)
Date de naissance
Date de naissance (nref: 304878), le jour n'est pas renvoyé
Année de la date de naissance
ex: 1932
Mois de la date de naissance
ex: 11
Attributs de la personne morale
Attributs spécifiques pour une personne morale. Si l'actionnaire n'est pas de type 'personne_morale', tous les champs seront null ou 'NS' (nref: 304859, 304857, 304858, 306875)
SIREN
ex: 110001013
Identifiant SIREN de la personne morale (nref: 304859)
Dénomination
ex: GOUVERNEMENT PREMIER MINISTRE
Dénomination de la personne morale (nref: 304857)
Complément de dénomination
Complément de dénomination de la personne morale (nref: 304858)
Forme juridique
ex: NS
Forme juridique (nref: 306875)
Adresse de l'actionnaire
Adresse de l'actionnaire (nref: pour personne morale [304862-304867] et pour personne physique [304872-304877])
Numéro
ex: 0057
Numéro de l'adresse (nref personne morale: 304862 | 304872)
Voie
ex: RUE DE VARENNE
Voie de l'adresse (nref personne morale: 304863 | personne physique: 304873)
Lieu-dit / Hameau
Lieu-dit ou hameau (nref personne morale: 304864 | personne physique: 304874)
Code postal
ex: 75007
Code postal (nref personne morale: 304865 | personne physique: 304875)
Ville
ex: PARIS
Ville (nref personne morale: 304866 | personne physique: 304876)
Pays
ex: FR
Pays, code iso 3166 (nref personne morale: 304867 | personne physique: 304877)
Répartition des actions
Répartition des actions entre personnes physiques et personnes morales (nref: 309326 et 309325 pour personnes physiques, 309324 et 309323 pour personnes morales). Si la liasse est absente, l'ensemble des valeurs sont à null
Personnes physiques
Détail des actions détenues par les personnes physiques (nref: total_actions 309326, nombre 309325)
Total des actions
ex: 490
Total des actions des personnes physiques (nref: 309326)
Nombre d'actions
ex: 2
Nombre d'actions répertoriées pour les personnes physiques (nref: 309325)
Personnes morales
Détail des actions détenues par les personnes morales (nref: total_actions 309324, nombre 309323)
Total des actions
ex: 510
Total des actions des personnes morales (nref: 309324)
Nombre d'actions
ex: 1
Nombre d'actions répertoriées pour les personnes morales (nref: 309323)
État du dépôt du formulaire 2059F
Indique l'état du dépôt du formulaire 2059F concernant la composition du capital social :

- false : l’imprimé est bien déposé et contient des données.
- true : l’imprimé est déposé à néant (vide).
- null : l’imprimé est complètement absent.

(nref: 305767)
Participations
Informations sur les participations de l'entreprise (nref: 2059G)
Liste des filiales
Liste des filiales de l'entreprise (nref: siren 304960, denomination 304958, complement_denomination 304959, forme_juridique 306876, pourcentage_detention 304967, adresse [304961 à 304966])
Cette propriété contient 1 ou plusieurs éléments ayant les spécifications suivantes :
SIREN de la filiale
ex: 130007669
Identifiant SIREN de la filiale (nref: 304960)
Dénomination
ex: ANSII
Dénomination de la filiale (nref: 304958)
Complément de dénomination
Complément de dénomination de la filiale (nref: 304959)
Forme juridique
ex: SA
Forme juridique de la filiale (nref: 306876)
Pourcentage de détention
ex: 42.0
Pourcentage de détention dans la filiale (nref: 304967)
Adresse de la filiale
Adresse de la filiale (nref: numéro 304961, voie 304962, lieu_dit_hameau 304963, code_postal 304964, ville 304965, pays 304966)
Numéro
ex: 0051 BOULEVARD DE LA TOUR-MAUBOURG
Numéro de l'adresse (nref: 304961)
Voie
Voie de l'adresse (nref: 304962)
Lieu-dit / Hameau
Lieu-dit ou hameau (nref: 304963)
Code postal
ex: 75007
Code postal (nref: 304964)
Ville
ex: PARIS
Ville (nref: 304965)
Pays
ex: FR
Pays, code iso 3166 (nref: 304966)
Nombre de filiales
ex: 1
Nombre de filiales déclarées (nref: 309327)
État du dépôt du formulaire 2059G
Indique l'état du dépôt du formulaire 2059G concernant les filiales et participations :

- false : l’imprimé est bien déposé et contient des données.
- true : l’imprimé est déposé à néant (vide).
- null : l’imprimé est complètement absent.

(nref: 305768)

Questions & réponses

Voici la liste complète des codes nref référencés dans ce service :

Imprimés :

  • 2059F : composition du capital
  • 2059G : participations / filiales

Capital social (CERFA 2059F) :

  • 304861 : pourcentage de détention (personne morale)
  • 304871 : pourcentage de détention (personne physique)
  • 304860 : nombre de parts (personne morale)
  • 304870 : nombre de parts (personne physique)
  • 306874 : civilité personne physique
  • 304868 : nom patronymique et prénoms (personne physique)
  • 304869 : nom marital (personne physique)
  • 304878 : date de naissance (jour non transmis)
  • 905900 : ville de naissance (non renvoyé ici)
  • 905901 : département de naissance (non renvoyé ici)
  • 905902 : pays de naissance (non renvoyé ici)
  • 304859 : siren (personne morale)
  • 304857 : dénomination (personne morale)
  • 304858 : complément de dénomination (personne morale)
  • 306875 : forme juridique (personne morale)
  • 304862 à 304867 : adresse personne morale (numéro, voie, lieu-dit, code postal, ville, pays)
  • 304872 à 304877 : adresse personne physique (numéro, voie, lieu-dit, code postal, ville, pays)
  • 309326 : total des actions détenues par des personnes physiques
  • 309325 : nombre de personnes physiques actionnaires
  • 309324 : total des actions détenues par des personnes morales
  • 309323 : nombre de personnes morales actionnaires
  • 305767 : dépôt néant (CERFA 2059F)

Participations (CERFA 2059G) :

  • 304960 : siren de la filiale
  • 304958 : dénomination de la filiale
  • 304959 : complément de dénomination de la filiale
  • 306876 : forme juridique de la filiale
  • 304967 : pourcentage de détention de la filiale
  • 304961 à 304966 : adresse de la filiale (numéro, voie, lieu-dit, code postal, ville, pays)
  • 309327 : nombre total de filiales
  • 305768 : dépôt néant (CERFA 2059G)



L’ensemble de ces données est également disponible via l’API Liasses fiscales, qui propose plus de champs (jour, lieu de naissance, etc.).

Les codes d’erreur de cette API sont spécifiques aux imprimés 2059F et 2059G. Si aucun des deux n’est disponible, l’API renvoie un code 404. Cela ne signifie pas que toutes les liasses fiscales sont absentes, mais simplement que, pour le SIREN et l’exercice demandés, les imprimés 2059F et 2059G ne sont pas trouvés.

Cette API ne met à disposition que certaines données sur les actionnaires personnes physiques (nom, prénoms, date de naissance partielle). Les informations de naissance complètes (jour, ville, département, pays) sont disponibles dans l’API Liasses fiscales qui expose davantage de champs déclaratifs.

Lorsqu’un imprimé n’est pas présent ou non déposé, le champ depose_neant peut être à null.

  • false : l’imprimé est bien déposé, et contient des données.
  • true : l’imprimé est déposé à néant (vide).
  • null : l’imprimé est complètement absent.

Conditions d'utilisation des données

Utilisation possible de la donnée :

Agent habilité ou usager authentifié

Conditions générales :

Cette API et l’utilisation de ses données est soumise aux CGU générales d’API Entreprise, dont voici les principaux éléments auxquels vous vous engagez :

  • ne demander que les données strictement nécessaires ;
  • ne pas utiliser votre jeton d’accès pour une démarche différente de celle indiquée lors de votre demande (le cas échéant le jeton sera révoqué) ;
  • présenter les données obtenues uniquement aux seuls agents habilités et à tracer l’accès de ces agents aux données ;
  • ne pas commercialiser les données reçues et à ne pas les communiquer à des tiers en dehors des cas prévus par la loi.
L’ensemble des conditions sont consultables et téléchargeables ci-dessous :

CGU API Entreprise

Cas d'usage

Liste des cas d'usage où cette API est utile :
Liste des cas d'usage où cette API est peut être utile :

Détails de l'API

Format de l'information

Donnée structurée JSON

Identifiants d'appel

Numéro de SIREN de l'entreprise
Année (fiscale) correspondant à l’exercice visé

Disponibilité

Temps réel :
Page de statut des API
En maintenance tous les jours de 01:00 à 02:00

Spécifications techniques :

Consulter le swagger Cas de tests