Logo de l'API Sirene

API Sirene - Documentation des services

Logo de l'Insee
retour au sommaire

Recherche sur une variable non-historisée

Permet de sélectionner les Siren (resp. les Siret) pour lesquels une certaine variable a une valeur spécifique. Dans le cas des variables non-historisées, il s'agit toujours de la valeur courante.

La syntaxe est la suivante : nomVariable:valeur

nomVariable doit correspondre exactement (casse comprise*) à la variable de sortie de l’interrogation unitaire. Toutes les variables peuvent être utilisées, y compris les indicatrices, avec quelques subtilités pour les variables au format date.

Exemples

Recherche de tous les établissements du Siren 775672272 : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=siren:775672272
Recherche de toutes les unités purgées : https://api.insee.fr/entreprises/sirene/V3.11/siren?q=unitePurgeeUniteLegale:true
Recherche de tous les établissements des unités purgées : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=unitePurgeeUniteLegale:true
Recherche de tous les établissements de la commune de Malakoff (code commune=92046) : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=codeCommuneEtablissement:92046

Recherche sur une variable historisée

Permet de sélectionner les Siren (respectivement les Siret) pour lesquels une certaine variable a une valeur spécifique sur au moins une période**. Dans le cas des variables historisées, on peut obtenir leur valeur courante ou la valeur qu'elles ont eue depuis la création de l'unité légale (respectivement l'établissement).

La syntaxe est la suivante : periode(nomVariable:valeur)

nomVariable doit correspondre exactement (casse comprise*) à la variable de sortie de l’interrogation unitaire.
Toutes les variables peuvent être utilisées, y compris les indicatrices, avec quelques subtilités pour les variables au format date. L'utilisation du paramètre date permet de limiter la recherche à une seule période (qui inclut la date saisie)

(*) Les noms de variables sont au format camelcase : premier mot tout en minuscules, les suivants avec l'initiale en majuscule, sans espaces ni accents (ex: economieSocialeSolidaireUniteLegale)
(**) Une période au sens de l'API est un intervalle de temps durant lequel aucune variable historisée n'a été modifiée. Le nombre de périodes est toujours supérieur ou égal à 1, pour les unités légales comme pour les établissements

Exemples

Recherche de toutes les UL dont la dénomination contient ou a contenu le mot GAZ : https://api.insee.fr/entreprises/sirene/V3.11/siren?q=periode(denominationUniteLegale:GAZ)
Recherche de toutes les UL qui ont été cessées : https://api.insee.fr/entreprises/sirene/V3.11/siren?q=periode(etatAdministratifUniteLegale:C)
Recherche de tous les établissements dont le code de l’activité principale a été (ou est(1)) 33.01 : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=periode(activitePrincipaleEtablissement:33.01)

(1) 33.01 appartenant à une ancienne nomenclature, une unité légale (resp. un établissement) ne peut pas avoir ce code en valeur courante si elle est active.

Commentaires

Pour un utilisateur n'ayant pas le droit d'accès aux données en diffusion partielle, un contrôle est fait sur chaque variable présente dans la requête multicritères (paramètre q). Les unités légales ou les établissements pour lesquels au moins l'une de ces variables est en diffusion partielle, n'apparaîtront pas dans les résultats de la recherche.
Les recherches sur variables historisées ou non-historisées sont accessibles par la console. Pour en savoir plus