 |
API Sirene - Documentation des services |
 |
Requête avec le paramètre date
L'ajout du paramètre date permet de spécifier à quelle date on souhaite que la variable interrogée ait la valeur recherchée (la variable ou les variables). Une unité légale ou un établissement répondant aux critères de sélection (q et date) sera renvoyé(e) intégralement, c'est à dire avec toutes ses périodes, contrairement à ce qui se passe en recherche unitaire.
Renseigner le paramètre date avec la date du jour ou une date dans le futur permet de ne s'intéresser qu'aux valeurs courantes des variables (seule la dernière période n'a pas de date de fin).
La syntaxe est la suivante :
- requête url : ?q={requête}&date=AAAA-MM-JJ
- requête console :
q : {requête}
date : AAAA-MM-JJ
Exemples
Recherche de toutes les UL actives au 18/09/2009 : https://api.insee.fr/entreprises/sirene/V3/siren?q=periode(etatAdministratifUniteLegale:A)&date=2009-09-18
Recherche de tous les établissements de Malakoff dont l’activitePrincipaleEtablissement est 56.10A (restauration traditionnelle) et actifs au 01/01/2018 : https://api.insee.fr/entreprises/sirene/V3/siret?q=periode(etatAdministratifEtablissement:A AND activitePrincipaleEtablissement:56.10A) AND codeCommuneEtablissement:92046 &date=2018-01-01
Commentaires
Attention à l’utilisation du paramètre date avec une recherche sur des variables non historisées : le service ne renverra que des unités légales (resp. établissements) existant à la date passée en paramètre. Par exemple, la recherche de tous les établissements du siren 212800130, avec paramètre date au 4 juillet 1980 (https://api.insee.fr/entreprises/sirene/V3/siret?q=siren:212800130&champs=siret,denominationUniteLegale,dateCreationEtablissement&date=1980-07-04) donne une erreur 404 (aucun écho), même si siren est une variable non-historisée, parce qu'aucun siret du siren 212800130 n'existe au 4 juillet 1980
Le paramètre date est également disponible pour les recherches par la console. Pour en savoir plus