Données établissement diffusible
Informations générales concernant un établissement diffusible inscrit au répertoire Sirene.
Fournisseur de la donnée
Insee
Périmètre
Entreprises ou associations concernées :
Cette API concerne les établissements inscrits au répertoire Sirene et “diffusibles” commercialement :
- ✅ les établissements des personnes morales de droit privé : les entreprises et les entrepreneurs individuels, dont toutes celles et ceux immatriculés au registre du commerce et des sociétés (RCS) et/ou au répertoire des métiers (RCM) ;
- ✅ les établissements des personnes morales de droit public : les institutions et services de l’État et les collectivités territoriales ;
- ✅ les établissements des associations ayant un numéro de SIRET délivré lorsqu’elles :
- emploient du personnel salarié ;
- sont soumises à la TVA ;
- ont demandé ou bénéficient de transferts financiers publics.
- ✅ Les établissements des organismes publics ou privés et les entreprises étrangères qui ont une représentation ou une activité en France.
✅ Depuis janvier 2022, les loueurs de meublés non professionnels (LMNP) et les particuliers employeurs, à l’exception des cas mentionnés au 2° de l’Article R123-220 du Code du Commerce, ont l’obligation d’être inscrits au répertoire Sirene.
Cette modification intervient suite au Décret n° 2021-1500 du 17 novembre 2021.
❌ Les établissements de gestion de paye de la fonction publique, bien que présents dans la base Sirene, ne sont pas concernés par cette API. Ils ont été immatriculés pour les seuls besoins de certaines administrations (les impôts, les URSSAF, la DGCP …).
Leur diffusion à d’autres administrations n’est donc pas prévue.
❌ Les établissements “non-diffusibles” ne sont pas couverts par cette API, leurs informations sont appelables avec cette API.
Périmètre géographique :
La base Sirene concerne les établissements implantés en métropole, dans les DOM et dans les collectivités d’Outre-Mer de Saint-Pierre-et-Miquelon, Saint-Barthélémy et Saint-Martin.
⚠️ Pour la Nouvelle-Calédonie, la Polynésie française, et Wallis-et-Futuna, seul le secteur public administratif, de l’État ou des communes est répertorié ;
❌ les entreprises ne sont donc pas disponibles.
Actualisation de la donnée :
La mise à jour des données est faite quotidiennement entre 0h et 3h à l’Insee.
En savoir plus :
L’article R123-220 du Code du commerce liste les entités tenues d’être inclues dans le répertoire Sirene par l’Insee.
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
Identifiant d'appel
Numéro de SIRET de l'établissement
Disponibilité
Page de statut des API
Horaires de fonctionnement :
7jours/7 et 24h/24
Spécifications techniques :
Consulter le swaggerLes données
À partir du numéro de SIRET de l’établissement, cette API délivre les informations générales de celui-ci et les informations générales de l’unité légale à laquelle l’établissement est rattaché.
Liste des champs de la réponse :
Siret de l'établissement
ex:
30613890001294
Il peut arriver que le siret renvoyé soit différent du paramètre d'appel. Il s'agit d'une erreur généralement temporaire dans la base de données Sirene.
État administratif de l'établissement
ex:
A
Cette valeur décrit l'état administratif de l'établissement, qui peut être :
- actif. Sauf exception, lors de son inscription au répertoire, tout établissement est à l'état 'actif'
- actif. Sauf exception, lors de son inscription au répertoire, tout établissement est à l'état 'actif'
- fermé. Cet état découle de la prise en compte d'une déclaration de fermeture. Un établissement fermé peut être rouvert.
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/etatAdministratifEtablissement
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/etatAdministratifEtablissement
Date de fermeture de l'établissement
ex:
1634133818
Cette valeur est renvoyée sous format timestamp
Attributs de l'activité principale
Code de l'activité principale (APE) de l'établissement
ex:
8411Z
Le code APE (activité principale exercée) permet d'identifier la branche d'activité principale. Il est attribué par l'Insee lors de l'immatriculation ou la déclaration d'activité de l'entreprise. Ce code de 4 chiffres + 1 lettre est extrait de la nomenclature d'activité française (NAF) de l'Insee.
À noter qu'un établissement n'ayant pas encore de code APE peut se voir affecter la valeur '00.00Z' de manière provisoire.
Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050 Nomemclature d'activité française - NAF rév.2 de l'Insee : https://www.insee.fr/fr/information/2120875
À noter qu'un établissement n'ayant pas encore de code APE peut se voir affecter la valeur '00.00Z' de manière provisoire.
Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050 Nomemclature d'activité française - NAF rév.2 de l'Insee : https://www.insee.fr/fr/information/2120875
Libellé associé au code APE
ex:
Administration publique générale
Libellé associé au code APE. Si le code n'est pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature en vigueur), le libellé n'est pas renseigné ici. Si le code ne correspond à aucun libellé au sein de la nomenclature 'Naf Rév2', la valeur 'non référencé' est utilisée.
Nomemclature d'activité française - NAF rév.2 de l'Insee : https://www.insee.fr/fr/information/2406147
Nomemclature d'activité française - NAF rév.2 de l'Insee : https://www.insee.fr/fr/information/2406147
Nomenclature associée au code
ex:
NAFRev2
Ce champ indique le nom de la nomenclature associée au code APE.
Tranche d'effectif salarié de l'établissement
Pour environ la moitié des établissements, la tranche d'effectif salarié n'est pas renseignée. Il s'agit principalement d'établissements récents (créés il y a moins de trois ans). Les délais de récolte et traitement font que les valeurs indiquées datent de l’année N-2 ou N-3.
Code effectif
ex:
51
Le code effectif correspond à la tranche d'effectif salarié de l'établissement :
- NN : Unités non employeuses (pas de salarié au cours de l'année de référence et pas d'effectif au 31/12). Cette tranche peut contenir quelques effectifs inconnus
- 00 : 0 salarié (n'ayant pas d'effectif au 31/12 mais ayant employé des salariés au cours de l'année de référence)
- 01 : 1 ou 2 salariés
- 02 : 3 à 5 salariés
- 03 : 6 à 9 salariés
- 11 : 10 à 19 salariés
- 12 : 20 à 49 salariés
- 21 : 50 à 99 salariés
- 22 : 100 à 199 salariés
- 31 : 200 à 249 salariés
- 32 : 250 à 499 salariés
- 41 : 500 à 999 salariés
- 42 : 1 000 à 1 999 salariés
- 51 : 2 000 à 4 999 salariés
- 52 : 5 000 à 9 999 salariés
- 53 : 10 000 salariés et plus
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/tefen.
L'effectif mensuel exact de l'établissement est disponible au travers de l'[API Effectifs - URSSAF Caisse nationale](TODO). Si votre jeton contient ce droit d'accès, nous vous recommandons d'utiliser cette API. Ces données étant protégées, leur cadre d'utilisation est différent de la tranche effectif fournie par l'Insee, qui elle est une donnée publique.
- NN : Unités non employeuses (pas de salarié au cours de l'année de référence et pas d'effectif au 31/12). Cette tranche peut contenir quelques effectifs inconnus
- 00 : 0 salarié (n'ayant pas d'effectif au 31/12 mais ayant employé des salariés au cours de l'année de référence)
- 01 : 1 ou 2 salariés
- 02 : 3 à 5 salariés
- 03 : 6 à 9 salariés
- 11 : 10 à 19 salariés
- 12 : 20 à 49 salariés
- 21 : 50 à 99 salariés
- 22 : 100 à 199 salariés
- 31 : 200 à 249 salariés
- 32 : 250 à 499 salariés
- 41 : 500 à 999 salariés
- 42 : 1 000 à 1 999 salariés
- 51 : 2 000 à 4 999 salariés
- 52 : 5 000 à 9 999 salariés
- 53 : 10 000 salariés et plus
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/tefen.
L'effectif mensuel exact de l'établissement est disponible au travers de l'[API Effectifs - URSSAF Caisse nationale](TODO). Si votre jeton contient ce droit d'accès, nous vous recommandons d'utiliser cette API. Ces données étant protégées, leur cadre d'utilisation est différent de la tranche effectif fournie par l'Insee, qui elle est une donnée publique.
Intitulé associé au code effectif
ex:
2 000 à 4 999 salariés
Date de référence de l'effectif
ex:
2016
Seuil inférieur de la tranche effectif
ex:
2000
Seuil supérieur de la tranche effectif
ex:
4999
Diffusable commercialement
ex:
true
Détermine si l'établissement est non-diffusible. Cette API n'appelant pas les non-diffusible, cette valeur est toujours à 'true'. Pour récupérer des établissements non-diffusibles, référez-vous à la documentation de l'API /insee/etablissements/:siren
Enseigne de l'établissement
ex:
Coiff Land, CoiffureLand
L'enseigne est l'appellation désignant l'emplacement ou le local dans lequel est exercée l'activité. Un établissement peut posséder une enseigne, plusieurs enseignes ou aucune.
Cette variable est la concaténation séparée par des virgules des 3 champs "renvoyés" par l'Insee. Plus d'informations ici: https://www.sirene.fr/sirene/public/variable/enseigne1Etablissement
Cette variable est la concaténation séparée par des virgules des 3 champs "renvoyés" par l'Insee. Plus d'informations ici: https://www.sirene.fr/sirene/public/variable/enseigne1Etablissement
Unité légale de l'établissement
Siren de l'unité légale
ex:
130025265
Il peut arriver que le siren renvoyé soit différent du paramètre d'appel. Il s'agit d'une erreur généralement temporaire dans la base de données Sirene.
Type de personne
ex:
personne_morale
Indique si l'unité légale est une personne morale ou une personne physique. Cette valeur est déterminée à l'aide du code juridique : '1000' correspondant à une personne physique.
Attributs de la personne morale
Attributs associés à la personne morale. Les valeurs sont à 'null' pour les personnes physiques.
Sigle de l'unité légale
ex:
DINUM
Attributs de la personne physique
Attributs associés à la personne physique. Les valeurs sont à 'null' pour les personnes morales.
Pseudonyme
ex:
DJ Falcon
Le pseudonyme correspond au nom qu'une personne utilise pour se désigner dans l'exercice de son activité, généralement littéraire ou artistique.
Prénom usuel
ex:
Jean
Le prénom usuel est le prénom par lequel une personne choisit de se faire appeler dans la vie courante. Ce prénom fait partie de ceux qui lui ont été donnés à sa naissance et qui sont inscrits à l'état civil.
Prénom numéro 1 déclaré
ex:
Jean
Prénom numéro 2 déclaré
ex:
Jacques
Prénom numéro 3 déclaré
ex:
Pierre
Prénom numéro 4 déclaré
ex:
Paul
Nom d'usage
ex:
Dupont
Nom que la personne physique a choisi d'utiliser.
Nom de naissance
ex:
Dubois
Genre
ex:
M
Caractère féminin ou masculin de la personne physique. Cette valeur peut ne pas être renseignée pour une personne physique.
Catégorie de l'unité légale
ex:
GE
Il s'agit d'une variable statistique calculée par l'Insee. Elle ne peut prendre que 3 valeurs:
- GE: Grande Entreprise
- ETI: Entreprise de Taille Intermédiaire
- PME: Petite ou Moyenne Entreprise
Celle-ci peut-être 'null' dans certains cas : quand il s’agit d’une unité légale nouvellement créée, ou bien d’une unité légale cessée, ou encore d’une unité légale hors champ du calcul de la catégorie (unité légale agricole ou ne faisant pas partie du système productif).
Définition de 'catégorie d'entreprise' par l'Insee : https://www.insee.fr/fr/metadonnees/definition/c1057
- GE: Grande Entreprise
- ETI: Entreprise de Taille Intermédiaire
- PME: Petite ou Moyenne Entreprise
Celle-ci peut-être 'null' dans certains cas : quand il s’agit d’une unité légale nouvellement créée, ou bien d’une unité légale cessée, ou encore d’une unité légale hors champ du calcul de la catégorie (unité légale agricole ou ne faisant pas partie du système productif).
Définition de 'catégorie d'entreprise' par l'Insee : https://www.insee.fr/fr/metadonnees/definition/c1057
Diffusable commercialement
ex:
true
Indique si l'unité légale est :
- une unité légale diffusible : 'true'
- une unité légale non-diffusible : 'false'. Dans ce cas, les informations obtenues ne doivent en aucun cas être accessibles au grand public.
Plus d'informations sur les conditions de diffusion : LIEN TODO
- une unité légale diffusible : 'true'
- une unité légale non-diffusible : 'false'. Dans ce cas, les informations obtenues ne doivent en aucun cas être accessibles au grand public.
Plus d'informations sur les conditions de diffusion : LIEN TODO
Attributs de la forme juridique
Code de la forme juridique de l'unité légale.
ex:
7120
Il existe plus de 300 catégories juridiques, identifiables par un code spécifique à quatre chiffres. Leur nomenclature comporte 3 niveaux. Le premier niveau de classement contient 9 grandes catégories identifiables avec le premier chiffre du code :
- 0 : Organisme de placement collectif en valeurs mobilières sans personnalité morale
- 1 : Entrepreneur individuel. La catégorie juridique des personnes physiques est '1000'.
- 2 : Groupement de droit privé non doté de la personnalité morale
- 3 : Personne morale de droit étranger
- 4 : Personne morale de droit public soumise au droit commercial
- 5 : Société commerciale
- 6 : Autre personne morale immatriculée au RCS
- 7 : Personne morale et organisme soumis au droit administratif
- 8 : Organisme privé spécialisé
- 9 : Groupement de droit privé
Nomenclature exhaustive des codes fournie par l'Insee : https://www.insee.fr/fr/information/2028129
- 0 : Organisme de placement collectif en valeurs mobilières sans personnalité morale
- 1 : Entrepreneur individuel. La catégorie juridique des personnes physiques est '1000'.
- 2 : Groupement de droit privé non doté de la personnalité morale
- 3 : Personne morale de droit étranger
- 4 : Personne morale de droit public soumise au droit commercial
- 5 : Société commerciale
- 6 : Autre personne morale immatriculée au RCS
- 7 : Personne morale et organisme soumis au droit administratif
- 8 : Organisme privé spécialisé
- 9 : Groupement de droit privé
Nomenclature exhaustive des codes fournie par l'Insee : https://www.insee.fr/fr/information/2028129
Libellé associé au code de la forme juridique de l'unité légale.
ex:
Service central d'un ministère
indique le libellé correspondant au code juridique. Si le code ne correspond à aucun libellé la valeur 'non référencé' est utilisée.
Nomenclature exhaustive fournie par l'Insee : https://www.insee.fr/fr/information/2028129
Nomenclature exhaustive fournie par l'Insee : https://www.insee.fr/fr/information/2028129
Attributs de l'activité principale
Code de l'activité principale (APE) de l'unité légale
ex:
8411Z
Le code APE (activité principale exercée) permet d'identifier la branche d'activité principale. Il est attribué par l'Insee lors de l'immatriculation ou la déclaration d'activité de l'entreprise. Ce code de 4 chiffres + 1 lettre est extrait de la nomenclature d'activité française (NAF) de l'Insee.
À noter qu'une entreprise n'ayant pas encore de code APE peut se voir affecter la valeur '00.00Z' de manière provisoire.
Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050 Nomemclature d'activité française - NAF rév.2 de l'Insee : https://www.insee.fr/fr/information/2120875
À noter qu'une entreprise n'ayant pas encore de code APE peut se voir affecter la valeur '00.00Z' de manière provisoire.
Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050 Nomemclature d'activité française - NAF rév.2 de l'Insee : https://www.insee.fr/fr/information/2120875
Libellé associé au code APE
ex:
Administration publique générale
Si le code n'est pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature en vigueur), le libellé n'est pas renseigné ici. Si le code ne correspond à aucun libellé au sein de la nomenclature 'Naf Rév2', la valeur 'non référencé' est utilisée.
Nomemclature d'activité française - NAF rév.2 de l'Insee : https://www.insee.fr/fr/information/2406147
Nomemclature d'activité française - NAF rév.2 de l'Insee : https://www.insee.fr/fr/information/2406147
Nomenclature associée au code
ex:
NAFRev2
Ce champ indique le nom de la nomenclature associée au code APE.
Tranche d'effectif salarié de l'unité légale
Pour environ la moitié des établissements, la tranche d'effectif salarié n'est pas renseignée. Il s'agit principalement d'établissements récents (créés il y a moins de trois ans). Les délais de récolte et traitement font que les valeurs indiquées datent de l’année N-2 ou N-3.
Code
ex:
51
Le code effectif indique la tranche d'effectif salarié de l'unité légale. Le nombre de salarié est déterminé en fonction de l'effectif de chacun des établissements de l'unité légale :
- NN : Unités non employeuses (pas de salarié au cours de l'année de référence et pas d'effectif au 31/12). Cette tranche peut contenir quelques effectifs inconnus
- 00 : 0 salarié (n'ayant pas d'effectif au 31/12 mais ayant employé des salariés au cours de l'année de référence)
- 01 : 1 ou 2 salariés
- 02 : 3 à 5 salariés
- 03 : 6 à 9 salariés
- 11 : 10 à 19 salariés
- 12 : 20 à 49 salariés
- 21 : 50 à 99 salariés
- 22 : 100 à 199 salariés
- 31 : 200 à 249 salariés
- 32 : 250 à 499 salariés
- 41 : 500 à 999 salariés
- 42 : 1 000 à 1 999 salariés
- 51 : 2 000 à 4 999 salariés
- 52 : 5 000 à 9 999 salariés
- 53 : 10 000 salariés et plus
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/tefen.
L'effectif exact de l'entreprise, mensuel et annuel, est disponible au travers de l'[API Effectifs - URSSAF Caisse nationale](TODO). Si votre jeton contient ce droit d'accès, nous vous recommandons d'utiliser cette API. Ces données étant protégées, leur cadre d'utilisation est différent de la tranche effectif fournie par l'Insee, qui elle est une donnée publique.
- NN : Unités non employeuses (pas de salarié au cours de l'année de référence et pas d'effectif au 31/12). Cette tranche peut contenir quelques effectifs inconnus
- 00 : 0 salarié (n'ayant pas d'effectif au 31/12 mais ayant employé des salariés au cours de l'année de référence)
- 01 : 1 ou 2 salariés
- 02 : 3 à 5 salariés
- 03 : 6 à 9 salariés
- 11 : 10 à 19 salariés
- 12 : 20 à 49 salariés
- 21 : 50 à 99 salariés
- 22 : 100 à 199 salariés
- 31 : 200 à 249 salariés
- 32 : 250 à 499 salariés
- 41 : 500 à 999 salariés
- 42 : 1 000 à 1 999 salariés
- 51 : 2 000 à 4 999 salariés
- 52 : 5 000 à 9 999 salariés
- 53 : 10 000 salariés et plus
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/tefen.
L'effectif exact de l'entreprise, mensuel et annuel, est disponible au travers de l'[API Effectifs - URSSAF Caisse nationale](TODO). Si votre jeton contient ce droit d'accès, nous vous recommandons d'utiliser cette API. Ces données étant protégées, leur cadre d'utilisation est différent de la tranche effectif fournie par l'Insee, qui elle est une donnée publique.
Intitulé associé au code effectif
ex:
2 000 à 4 999 salariés
Date de référence de l'effectif
ex:
2016
Seuil inférieur de la tranche effectif
ex:
2000
Seuil supérieur de la tranche effectif
ex:
4999
État administratif de l'unité légale
ex:
A
Cette valeur décrit l'état administratif de l'unité légale, qui peut être :
- cessée. Le passage à l'état « Cessée » découle de la prise en compte d'une déclaration de cessation administrative. Pour les personnes morales, cela correspond au dépôt de la déclaration de disparition de la personne morale. Pour les personnes physiques, cela correspond soit à la prise en compte de la déclaration de cessation d'activité déposée par l'exploitant soit au décès de l'exploitant conformément à la réglementation.
- active. En dehors des cas explicités ci-dessus, l'unité légale est toujours à l'état administratif « Active ».
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/etatAdministratifUniteLegale
- cessée. Le passage à l'état « Cessée » découle de la prise en compte d'une déclaration de cessation administrative. Pour les personnes morales, cela correspond au dépôt de la déclaration de disparition de la personne morale. Pour les personnes physiques, cela correspond soit à la prise en compte de la déclaration de cessation d'activité déposée par l'exploitant soit au décès de l'exploitant conformément à la réglementation.
- active. En dehors des cas explicités ci-dessus, l'unité légale est toujours à l'état administratif « Active ».
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/etatAdministratifUniteLegale
Date de création de l'unité légale
ex:
1634103818
La date de création correspond à la date qui figure dans les statuts de l'entreprise qui sont déposés au centre de formalité des entreprises (CFE) compétent. Cette valeur est renvoyée sous format timestamp.
Pour certains établissements très anciens, tous fermés et dont l’unité légale est cessée la date de création peut être nulle.
Pour les unités purgées, la date de création n'est jamais à 'null'. Si elle est non renseignée, elle sera au 01/01/1900.
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/dateCreationUniteLegale
Pour certains établissements très anciens, tous fermés et dont l’unité légale est cessée la date de création peut être nulle.
Pour les unités purgées, la date de création n'est jamais à 'null'. Si elle est non renseignée, elle sera au 01/01/1900.
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/dateCreationUniteLegale
Adresse de l'établissement
Numéro dans la voie
ex:
22
Indice de répétition du numéro dans la voie
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/indrep
Type de la voie de localisation
ex:
RUE
Le type de la voie de localisation est indiquée en abrégé et en majuscules. L'information n'est pas toujours renseignée. Pour certaines petites communes, l'information n'existe pas.
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/typvoie
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/typvoie
Libellé de la voie
ex:
DE LA PAIX
Complément d'adresse
ex:
ZAE SAINT GUENAULT
Le complément d'adresse correspond à des éléments situés à l'extérieur du bâtiment qui permettent de compléter l'adresse (résidence, bâtiment, entrée, etc..)
Code commune
ex:
75112
Le code commune désigne le code de la commune de localisation de l'établissement. Le code renvoyé correspond à la date de l'appel, ce qui implique que toute modification du code commune est repercutée sur l'ensemble des établissements concernés, y compris ceux qui sont fermés. Cette valeur est à 'null' pour les entreprises à l'étranger.
Les codes sont listés dans la table d'appartenance géographique fournie par l'Insee et disponible ici: https://www.insee.fr/fr/information/2028028
Les codes sont listés dans la table d'appartenance géographique fournie par l'Insee et disponible ici: https://www.insee.fr/fr/information/2028028
Code postal
ex:
75016
Distribution spéciale
La distribution spéciale reprend les éléments particuliers qui accompagnent une adresse de distribution spéciale, la modalité la plus connue étant les adresses en 'CEDEX'.
Plus d'informations dans la documentation Insee de l'API Sirene : * https://www.sirene.fr/sirene/public/variable/distributionSpecialeEtablissement * https://www.sirene.fr/sirene/public/variable/l5-disp
Plus d'informations dans la documentation Insee de l'API Sirene : * https://www.sirene.fr/sirene/public/variable/distributionSpecialeEtablissement * https://www.sirene.fr/sirene/public/variable/l5-disp
Code cedex
ex:
75590
Plus d'informations : https://fr.wikipedia.org/wiki/Courrier_d%27entreprise_%C3%A0_distribution_exceptionnelle
Libellé du code cedex
ex:
PARIS CEDEX 12
Ce champ indique le libellé correspondant au code cedex de l'établissement. Si le code cedex est à 'null', ce champ est également à 'null'.
Nom de la commune pour une adresse en France
ex:
PARIS 12
Cette valeur est à 'null' pour les établissements à l'étranger.
Nom de la commune pour une adresse à l'étranger.
Cette valeur est à 'null' pour les établissements en France.
Code du pays pour les établissements situés à l'étranger
ex:
99132
La nomenclature des codes pays se trouve ici: https://www.insee.fr/fr/information/2028273
Nom du pays pour les établissements situés à l'étranger
ex:
ROYAUME-UNI
Éléments constitutifs de l'adresse postale pour son acheminement.
Il ne s'agit pas d'un traitement RNVP mais simplement d'une réorganisation des éléments renvoyé par l'Insee pour faciliter l'affichage des adresses postales
Ligne 1
ex:
DIRECTION INTERMINISTERIELLE DU NUMERIQUE
Si l'établissement correspond à une personne morale: la dénomination sociale de la personne morale. Le cas contraire: cette variable est vide.
Ligne 2
ex:
JEAN MARIE DURAND
Si l'établissement correspond à une personne physique: concaténation du nom et prénom
Ligne 3
ex:
ZAE SAINT GUENAULT
Complément d'adresse comme décrit dans la clé `complement_adresse`
Ligne 4
ex:
51 BIS RUE DE LA PAIX
Concaténation du numéro de voie, d'indice de répétition, du type de voie et du libellé de la voie
Ligne 5
ex:
CS 72809
Distribution spéciale comme décrit dans la clé `distribution_speciale`
Ligne 6
ex:
75256 PARIX CEDEX 12
Si le code cedex est existant: code cedex accompagné de son libellé ; sinon, si le pays est en France: code postal accompagné de son libellé, sinon : libellé de la commune de l'établissement situé à l'étranger
Ligne 7
ex:
FRANCE
Pays de l'établissement
Date de création de l'unité légale
ex:
1634103818
La date de création correspond à la date qui figure dans les statuts de l'entreprise qui sont déposés au centre de formalité des entreprises (CFE) compétent. Cette valeur est renvoyée sous format timestamp.
Pour certains établissements très anciens, tous fermés et dont l’unité légale est cessée la date de création peut être nulle.
Pour les unités purgées, la date de création n'est jamais à 'null'. Si elle est non renseignée, elle sera au 01/01/1900.
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/dateCreationUniteLegale
Pour certains établissements très anciens, tous fermés et dont l’unité légale est cessée la date de création peut être nulle.
Pour les unités purgées, la date de création n'est jamais à 'null'. Si elle est non renseignée, elle sera au 01/01/1900.
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/dateCreationUniteLegale
Liens à la racine :
Ces liens sont présents dans la réponse et permettent d'appeler automatiquement d'autres API du catalogue en lien avec celle-ci.
Unite legale
ex:
https://entreprise.api.gouv.fr/api/v3/insee/unites_legales/130025265
Lien vers la ressource 'Donnée Sirene d'une unité légale' correspondant à cette adresse d'établissement pour obtenir les données de référence de l'unité légale.
Métadonnées racine :
Les métadonnées sont des données généralement liées au contexte de la ressource : mise à jour chez le fournisseurs, informations système, etc...
Date derniere mise a jour
ex:
1618396818
Date de la dernière mise à jour à l'Insee.
Siret d'origine de la requête
ex:
30613890000010
Si la requête a été effectuée sur un siret qui a été redirigé vers un autre siret , cette variable contient le siret d'origine de la requête. Cela arrive parfois lorsque la base Sirene possède des unités légales en doublons. Ces doublons sont généralement temporaires.
Si cette variable est renseignée, le paramètre data->siret est différent du paramètre d'appel, et cette variable est le siret d'entrée.
A noter que le siret de redirection est systématiquement le siret du siège social de l'unité légale: en effet la base Sirene ne possède pas la correspondance exacte entre un siret doublon et le siret d'origine.
Si cette variable est renseignée, le paramètre data->siret est différent du paramètre d'appel, et cette variable est le siret d'entrée.
A noter que le siret de redirection est systématiquement le siret du siège social de l'unité légale: en effet la base Sirene ne possède pas la correspondance exacte entre un siret doublon et le siret d'origine.
Questions & réponses
L’état administratif d’un établissement a deux modalités : actif ou fermé.
Lors de son inscription au répertoire Sirene, un établissement est, sauf exception, à l’état “actif”.
Le passage à l’état “fermé” découle de la prise en compte d’une déclaration de fermeture.
Un établissement fermé peut être rouvert.
Parmi les entités présentes dans le répertoire Sirene, certaines, très majoritairement des personnes physiques, ont explicitement demandé de ne pas figurer en diffusion commerciale, en vertu de l’article A123-96 du Code du Commerce.
Cela signifie qu’elles donnent accord de la diffusion de leur données uniquement à des organismes habilités et à des administrations. De fait, leurs données ne sont pas publiques.
⚠️ Attention les informations des personnes physiques ne sont plus accessibles pour quiconque une fois qu’elles ont cessé leur activité.
ℹ️ Les unités de la Défense nationale font également partie des “non-diffusibles” mais ne sont accessibles que sur autorisation du Ministère de la Défense, conformément à l’article A123-96 du Code du Commerce
En utilisant cette API, vous vous engagez à tenir compte du statut de diffusion le plus récent de l’entité appelée.
Dans le cas où l’entité est indiquée comme "non-diffusible", vous vous engagez à n’utiliser leurs informations que dans le cadre strict de vos missions de service public, à ne pas les rediffuser ni les divulguer auprès de tiers non autorisés.
⚠️ Vous ne pouvez pas donc pas faire usage des données d’une entité “non-diffusible” pour du préremplissage.
Il vous est par contre possible d’indiquer à l’entité “non-diffusible” qu’elle peut modifier son statut, même provisoirement, auprès de l’Insee à l’adresse suivante : https://statut-diffusion-sirene.insee.fr).
Conditions d'utilisation des données
Ouverture de la donnée :
Données ouvertes
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.
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
Identifiant d'appel
Numéro de SIRET de l'établissement
Disponibilité
Page de statut des API
Horaires de fonctionnement :
7jours/7 et 24h/24