Données établissement en open data
Informations générales publiques concernant un établissement inscrit au répertoire Sirene. API incluse par défaut
Fournisseur de la donnée
INSEE
Périmètre
Entreprises ou associations concernées :
Cette API concerne les établissements inscrits au répertoire Sirene :
- ✅ 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 (RM) ;
- ✅ 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 personnes morales de droit public : les institutions et services de l’État et les collectivités territoriales ;
- ✅ Les établissements des organismes publics ou privés et les entreprises étrangères qui ont une représentation ou une activité en France.
- ✅ Les établissements des loueurs de meublés non professionnels (LMNP) et les particuliers employeurs (depuis 2022), à 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.
💡 Seules des données publiques sont disponibles avec cette API.
Pour obtenir les données protégées du million d’établissements “en diffusion partielle”, essentiellement des entreprises individuelles, veuillez utiliser cette API.
Périmètre géographique :
La base Sirene concerne les établissements implantés en métropole, dans les DROM 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'usages
API utile pour :
API parfois utile pour :
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
Disponible 24h/24 et 7j/7
Spécifications techniques :
Consulter le swagger Cas de testsLes 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é.
Cette API délivre uniquement des données publiques. Pour obtenir les données protégées du million d’établissements en “diffusion partielle”, essentiellement des entreprises individuelles, utilisez cette API.
Informations renvoyées en JSON :
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. Si le code n'est pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature en vigueur), le code est null ici.
À 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.
⚠️ À partir de janvier 2026, le code APE utilisera la nouvelle nomenclature NAF 2025, tel qu'explicité dans ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067. Des tables de correspondance seront fournies par 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.
⚠️ À partir de janvier 2026, le code APE utilisera la nouvelle nomenclature NAF 2025, tel qu'explicité dans ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067. Des tables de correspondance seront fournies par l'Insee.
Libellé associé au code APE
ex:
Administration publique générale
Libellé associé au code APE. 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. Si le code n'est pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature en vigueur), la nomenclature null ici.
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
Statut de la diffusion
Indique le statut de diffusion de l'établissement :
- Diffusible : Toutes les données de l'établissement sont diffusibles, donc publiques.
- Partiellement diffusible : Seule une partie des données est diffusible, suite à une demande de l'entité qui a exercé sont droit d'opposition à la diffusion de données personnelles.
- Non-diffusible (obsolète) : Ce statut correspond à l'ancien statut, toutes les entités ayant exercé leur droit d'opposition sont normalement désormais en statut "partiellement diffusible".
- Diffusible : Toutes les données de l'établissement sont diffusibles, donc publiques.
- Partiellement diffusible : Seule une partie des données est diffusible, suite à une demande de l'entité qui a exercé sont droit d'opposition à la diffusion de données personnelles.
- Non-diffusible (obsolète) : Ce statut correspond à l'ancien statut, toutes les entités ayant exercé leur droit d'opposition sont normalement désormais en statut "partiellement diffusible".
Indique si les données renvoyées sont entièrement publiques et donc diffusables
ex:
true
Ce champ permet de savoir s'il est possible de diffuser les données sans restriction ou bien si des données protégées sont présentes dans la payload (ce qui est le cas lorsque l'unité légale est en statut de diffusion partielle). Pour une unité légale :
- diffusible : 'true', car toutes les données sont publiques ;
- partiellement-diffusible : 'false', une partie des données est protégée et ne doit pas être diffusée, pour du pré-remplissage de formulaire public, préférer l'API en open data qui masque automatiquement les données protégées ;
- non-diffusible (obsolète) : 'false', dans ce cas, les informations obtenues ne doivent en aucun cas être accessibles au grand public. Ce cas n'étant plus censé exister, préférer l'API en open data qui masque automatiquement les données protégées.
Plus d'informations sur les conditions de diffusion : https://sirene.fr/static-resources/htm/v_sommaire.htm#26
- diffusible : 'true', car toutes les données sont publiques ;
- partiellement-diffusible : 'false', une partie des données est protégée et ne doit pas être diffusée, pour du pré-remplissage de formulaire public, préférer l'API en open data qui masque automatiquement les données protégées ;
- non-diffusible (obsolète) : 'false', dans ce cas, les informations obtenues ne doivent en aucun cas être accessibles au grand public. Ce cas n'étant plus censé exister, préférer l'API en open data qui masque automatiquement les données protégées.
Plus d'informations sur les conditions de diffusion : https://sirene.fr/static-resources/htm/v_sommaire.htm#26
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
Si la personne morale est en diffusion partielle, l'enseigne n'est pas renvoyée, et la valeur est remplacée par "[ND]".
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
Si la personne morale est en diffusion partielle, l'enseigne n'est pas renvoyée, et la valeur est remplacée par "[ND]".
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.
Numéro RNA de l'unité légale
ex:
W751004076
Ce champ n'est rempli que si l'unité légale est également une association enregistré dans le RNA.
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
Si la personne morale est en diffusion partielle, le sigle n'est pas renvoyé, et la valeur est remplacée par "[ND]".
Attributs de la personne physique
Attributs associés à la personne physique. Les valeurs sont à 'null' pour les personnes morales. Pour les personnes physiques, la raison sociale / dénomination / nom de l'entreprise correspond toujours au nom de famille et au prénom, précédés ou suivis de la mention "entrepreneur individuel" ou "EI". Pour en savoir plus, consulter cette page du site service-public.fr https://entreprendre.service-public.fr/vosdroits/F23283/personnalisation/resultat
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.
Si la personne physique est en diffusion partielle, le pseudonyme n'est pas renvoyé et la valeur est remplacée par "[ND]".
Si la personne physique est en diffusion partielle, le pseudonyme n'est pas renvoyé et la valeur est remplacée par "[ND]".
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.
Si la personne physique est en diffusion partielle, le prénom usuel n'est pas renvoyé et la valeur est remplacée par "[ND]".
Si la personne physique est en diffusion partielle, le prénom usuel n'est pas renvoyé et la valeur est remplacée par "[ND]".
Prénom numéro 1 déclaré
ex:
Jean
Si la personne physique est en diffusion partielle, le prénom n'est pas renvoyé et la valeur est remplacée par "[ND]".
Prénom numéro 2 déclaré
ex:
Jacques
Si la personne physique est en diffusion partielle, le prénom n'est pas renvoyé et la valeur est remplacée par "[ND]".
Prénom numéro 3 déclaré
ex:
Pierre
Si la personne physique est en diffusion partielle, le prénom n'est pas renvoyé et la valeur est remplacée par "[ND]".
Prénom numéro 4 déclaré
ex:
Paul
Si la personne physique est en diffusion partielle, le prénom n'est pas renvoyé et la valeur est remplacée par "[ND]".
Nom d'usage
ex:
Dupont
Nom que la personne physique a choisi d'utiliser.
Si la personne physique est en diffusion partielle, le nom d'usage n'est pas renvoyé et la valeur est remplacée par "[ND]".
Si la personne physique est en diffusion partielle, le nom d'usage n'est pas renvoyé et la valeur est remplacée par "[ND]".
Nom de naissance
ex:
Martin
Si la personne physique est en diffusion partielle, le nom de naissance n'est pas renvoyé et la valeur est remplacée par "[ND]".
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.
Si la personne physique est en diffusion partielle, la valeur est remplacée par "[ND]".
Si la personne physique est en diffusion partielle, la valeur est remplacée par "[ND]".
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
Statut de la diffusion
Indique le statut de diffusion de l'unité légale :
- Diffusible : Toutes les données de l'unité légale sont diffusibles, donc publiques.
- Partiellement diffusible : Seule une partie des données est diffusible, suite à une demande de l'entité qui a exercé sont droit d'opposition à la diffusion de données personnelles.
- Non-diffusible (obsolète) : Ce statut correspond à l'ancien statut, toutes les entités ayant exercé leur droit d'opposition sont normalement désormais en statut "partiellement diffusible".
- Diffusible : Toutes les données de l'unité légale sont diffusibles, donc publiques.
- Partiellement diffusible : Seule une partie des données est diffusible, suite à une demande de l'entité qui a exercé sont droit d'opposition à la diffusion de données personnelles.
- Non-diffusible (obsolète) : Ce statut correspond à l'ancien statut, toutes les entités ayant exercé leur droit d'opposition sont normalement désormais en statut "partiellement diffusible".
Indique si les données renvoyées sont entièrement publiques et donc diffusables
ex:
true
Ce champ est a priori toujours à 'true' car cette API ne renvoie que de l'open data. Pour une unité légale :
- diffusible : 'true', car toutes les données sont publiques ;
- partiellement-diffusible : 'true'. Dans ce cas, les informations protégées suite au droit d'opposition sont masquées par la chaîne de caractère '[ND]' ;
Plus d'informations sur les conditions de diffusion : https://sirene.fr/static-resources/htm/v_sommaire.htm#26
- diffusible : 'true', car toutes les données sont publiques ;
- partiellement-diffusible : 'true'. Dans ce cas, les informations protégées suite au droit d'opposition sont masquées par la chaîne de caractère '[ND]' ;
Plus d'informations sur les conditions de diffusion : https://sirene.fr/static-resources/htm/v_sommaire.htm#26
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. Si le code n'est pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature en vigueur), le code est null ici.
À 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.
⚠️ À partir de janvier 2026, le code APE utilisera la nouvelle nomenclature NAF 2025, tel qu'explicité dans ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067. Des tables de correspondance seront fournies par 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.
⚠️ À partir de janvier 2026, le code APE utilisera la nouvelle nomenclature NAF 2025, tel qu'explicité dans ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067. Des tables de correspondance seront fournies par l'Insee.
Libellé associé au code APE
ex:
Administration publique générale
Libellé associé au code APE. 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. Si le code n'est pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature en vigueur), la nomenclature null ici.
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. 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. 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 « active » ou « cessée »
**Pour les personnes morales**, l'unité légale est considérée comme juridiquement « cessée » si :
- il y a eu dépôt de la déclaration de disparition de la personne morale ;
- elle a été inscrite sans activité à sa demande. Dans le cas d'une création au répertoire Sirene mais sans avoir encore démarré une activité (activité principale provisoire “0000Z”) ;
- elle n'a plus d'établissement en activité.
**Pour les personnes physiques**, l'unité légale est considérée comme juridiquement « cessée » si :
- l'exploitant de l'unité légale décède ;
- l'exploitant dépose une cessation d'activité.
En dehors de ces cas, l'état administratif de l'unité légale est toujours « actif ».
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/etatAdministratifUniteLegale
**Pour les personnes morales**, l'unité légale est considérée comme juridiquement « cessée » si :
- il y a eu dépôt de la déclaration de disparition de la personne morale ;
- elle a été inscrite sans activité à sa demande. Dans le cas d'une création au répertoire Sirene mais sans avoir encore démarré une activité (activité principale provisoire “0000Z”) ;
- elle n'a plus d'établissement en activité.
**Pour les personnes physiques**, l'unité légale est considérée comme juridiquement « cessée » si :
- l'exploitant de l'unité légale décède ;
- l'exploitant dépose une cessation d'activité.
En dehors de ces cas, l'état administratif de l'unité légale est toujours « actif ».
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
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
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
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
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
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
Plus d'informations dans la documentation Insee de l'API Sirene : https://www.sirene.fr/sirene/public/variable/typvoie
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
Libellé de la voie
ex:
DE LA PAIX
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
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..)
Si la personne morale est en diffusion partielle, le complément d'adresse n'est pas renvoyé, et la valeur est remplacée par "[ND]".
Si la personne morale est en diffusion partielle, le complément d'adresse n'est pas renvoyé, et la valeur est remplacée par "[ND]".
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
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
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
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
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
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
Code cedex
ex:
75590
Plus d'informations : https://fr.wikipedia.org/wiki/Courrier_d%27entreprise_%C3%A0_distribution_exceptionnelle
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
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'.
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
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
Statut de la diffusion
Indique le statut de diffusion de l'établissement :
- Diffusible : Toutes les données de l'établissement sont diffusibles, donc publiques.
- Partiellement diffusible : Seule une partie des données est diffusible, suite à une demande de l'entité qui a exercé sont droit d'opposition à la diffusion de données personnelles.
- Non-diffusible (obsolète) : Ce statut correspond à l'ancien statut, toutes les entités ayant exercé leur droit d'opposition sont normalement désormais en statut "partiellement diffusible".
- Diffusible : Toutes les données de l'établissement sont diffusibles, donc publiques.
- Partiellement diffusible : Seule une partie des données est diffusible, suite à une demande de l'entité qui a exercé sont droit d'opposition à la diffusion de données personnelles.
- Non-diffusible (obsolète) : Ce statut correspond à l'ancien statut, toutes les entités ayant exercé leur droit d'opposition sont normalement désormais en statut "partiellement diffusible".
É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.
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
Ligne 2
ex:
JEAN MARIE DURAND
Si l'établissement correspond à une personne physique : concaténation du nom et prénom
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
Ligne 3
ex:
ZAE SAINT GUENAULT
Si l'établissement correspond à une personne physique : concaténation du nom et prénom
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
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
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
Ligne 5
ex:
CS 72809
Distribution spéciale comme décrit dans la clé `distribution_speciale`
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
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
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
Si la personne morale est en diffusion partielle, la valeur est remplacée par "[ND]".
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
À gros trait, l’état administratif vous permet de vérifier si l’entreprise ou l’association est en activité. Il faut pour cela distinguer et vérifier l’état administratif de l’unité légale et celui de ses établissments.
État administratif de l’unité légale :
L’état administratif de l’unité légale peut être “actif” ou “cessé”.
L’unité légale est toujours active, sauf si une déclaration de cessation administrative a été déposée et prise en compte par l’Insee.
L’état administratif indique si une unité légale est active ou cessée.
État administratif d’un établissement :
Il peut être “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.
Cas particuliers :
- une unité légale est active alors que tous ses établissements sont fermés. Il s’agit alors d’une entité active d’un point de vue administratif mais n’ayant pas d’activité économique. Cette situation regroupe :
- Les sociétés en sommeil, c’est-à-dire faire reconnaître par une formalité leur état en sommeil afin de ne plus avoir certaines obligations fiscales ;
- Les sociétés présumées inactives, identifiées par l’Insee pour des besoins statistiques.
La distinction “en sommeil” ou “présumée inactive” n’est pas une information transmise par l’Insee.
- une unité légale est cessée alors qu’un établissement est actif. Cette situation est une erreur à signaler au pôle du répertoire Sirene à l’Insee. Une unité légale cessée ne peut avoir d’établissements actifs.
La diffusion partielle commerciale :
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 totale, afin de ne pas rendre publiques leurs données d’identification et de localisation. L’Insee évalue leur nombre a plus d’un million d’établissements (chiffre 2025), essentiellement des entreprises individuelles.
Ce droit d’opposition tel que décrit à l’Article 21 du RGPD est valable pour les personnes physiques et morales mais s’applique de façon différente :
- pour les personnes morale, seuls les éléments de localisation sont protégés (géolocalisation, numéro et voie de l’adresse postale - la commune reste diffusible) ;
- pour les personnes physiques, les éléments de localisation précédents sont protégés, ainsi que les éléments d’identification (nom, prénom, pseudonyme).
Ces données protégées sont alors uniquement accessibles à des organismes habilités et à des administrations. Elles sont disponibles dans l’API Entreprise.
Le statut de diffusion partielle est nouveau, il est venu remplacer le statut “non-diffusible” en 2023. Ce nouveau statut rend public plus d’informations, dont, pour les personnes physiques, le SIREN, SIRET, la commune et le pays, ainsi que l’état administratif et les variables économiques. Il a élargi la possibilité de la diffusion partielle aux personnes morales, pour leur permettre de cacher leurs données de localisation.
Lire notre publication du 14/12/2022 : 🦸 Le futur des “non-diffusibles”.
La non-diffusion totale disponibles pour des cas spécifiques :
Certaines entités ne sont pas diffusibles pour d’autres raisons que la non-diffusion commerciale. C’est par exemple le cas :
- des établissements de gestion de paye de la fonction publique immatriculés pour les seuls besoins de certaines administrations (les impôts, les URSSAF, la DGCP …) et donc uniquement accessibles à ces administrations fiscales.
- des unités de la Défense nationale, accessibles sur autorisation du Ministère de la Défense, conformément à l’article A 123-95 du Code du commerce. Ces unités ne sont pas diffusées par l’API Entreprise.
Cette API délivre uniquement des données publiques. Par conséquent, vous pouvez utiliser les données disponibles dans tous vos services, qu’ils soient accessibles avec ou sans authentification.
Pour obtenir les données protégées du million d’établissements en “diffusion partielle”, essentiellement des entreprises individuelles, utilisez cette API.
Conditions d'utilisation des données
Utilisation possible de la donnée :
Publique
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'usages
API utile pour :
API parfois utile pour :
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
Disponible 24h/24 et 7j/7