API Sirene - Documentation des services

retour au sommaire

---

Recherche unitaires ou multicritères : paramétrage de la liste des variables en sortie

Pour toutes les requêtes (unitaires ou multicritères) il est possible de restreindre le nombre de variables en sortie avec le paramètre champs, pour le format Json comme pour le format CSV. Ce paramètre devra contenir la liste des variables désirées, séparées par une virgule. Par défaut le paramètre champs contient toutes les variables disponibles.
Si le paramètre champs contient un libellé de variable inconnu, l’application renverra un code erreur 400.
Les variables « englobantes » telles Periodes, Adresse n’apparaîtront dans la sortie que si une variable les concernant est présente dans le paramètre champs. De même si une variable historisée est présente dans le paramètre, les variables dateDebut et dateFin seront également présentes dans la sortie.

Exemples

Recherche unitaire du siret 39860733300059, avec en sortie le nom de l'unité légale et date de création de l'établissement (deux variables non-historisées) :
https://api.insee.fr/api-sirene/3.11/siret/39860733300059?champs=nomUniteLegale,dateCreationEtablissement
Sortie Json (pas de sortie csv)

{
    "header": {
        "statut": 200,
        "message": "ok"
    },
    "etablissement": {
        "dateCreationEtablissement": "2015-01-09",
        "uniteLegale": {
            "nomUniteLegale": "GRONDIN"
        }
    }
}

Recherche unitaire du siren 272602327, avec en sortie la date de création de l'unité légale (variable non-historisée) et sa dénomination (variable historisée) :
https://api.insee.fr/api-sirene/3.11/siren/272602327?champs=dateCreationUniteLegale,denominationUniteLegale
Sortie Json (pas de sortie csv)

{
    "header": {
        "statut": 200,
        "message": "OK"
    },
    "uniteLegale": {
        "dateCreationUniteLegale": "1992-10-05",
        "periodesUniteLegale": [
            {
                "dateFin": null,
                "dateDebut": "1995-12-25",
                "denominationUniteLegale": "SERVICE D'ASSAINISSEMENT DE BEAUVALLON"
            }
        ]
    }
}

Recherche multicritères des établissements créés en 2021 et qui ont 9 périodes, avec en sortie le siret, la catégorie juridique de l'unité légale (variables non-historisées) et l'activité principale de l'établissement (variable historisée) :
https://api.insee.fr/api-sirene/3.11/siret?q=nombrePeriodesEtablissement:9 AND dateCreationEtablissement:2021&champs=siret,categorieJuridiqueUniteLegale,activitePrincipaleEtablissement

Sortie Json : toutes les valeurs historiques des variables historisées sont éditées, même si la donnée est manquante (null) ou identique pour plusieurs périodes.

{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 2,
        "debut": 0,
        "nombre": 2
    },
    "etablissements": [
        {
            "siret": "34513048800017",
            "uniteLegale": {
                "categorieJuridiqueUniteLegale": "5710"
            },
            "periodesEtablissement": [
                {
                    "dateFin": null,
                    "dateDebut": "2018-03-01",
                    "activitePrincipaleEtablissement": "68.20B"
                },
                {
                    "dateFin": "2018-02-28",
                    "dateDebut": "2016-12-12",
                    "activitePrincipaleEtablissement": "70.10Z"
                },
                {
                    "dateFin": "2016-12-11",
                    "dateDebut": "2015-10-05",
                    "activitePrincipaleEtablissement": "68.20B"
                },
                {
                    "dateFin": "2015-10-04",
                    "dateDebut": "2008-01-01",
                    "activitePrincipaleEtablissement": "70.10Z"
                },
                {
                    "dateFin": "2007-12-31",
                    "dateDebut": "2005-12-02",
                    "activitePrincipaleEtablissement": "74.1J"
                },
                {
                    "dateFin": "2005-12-01",
                    "dateDebut": "2005-01-01",
                    "activitePrincipaleEtablissement": "70.2C"
                },
                {
                    "dateFin": "2004-12-31",
                    "dateDebut": "2002-12-25",
                    "activitePrincipaleEtablissement": "74.1J"
                },
                {
                    "dateFin": "2002-12-24",
                    "dateDebut": "2000-12-31",
                    "activitePrincipaleEtablissement": null
                },
                {
                    "dateFin": "2000-12-30",
                    "dateDebut": "1988-06-02",
                    "activitePrincipaleEtablissement": null
                }
            ]
        },
        {
            "siret": "42267396200011",
            "uniteLegale": {
                "categorieJuridiqueUniteLegale": "1000"
            },
            "periodesEtablissement": [
                {
                    "dateFin": null,
                    "dateDebut": "2021-05-10",
                    "activitePrincipaleEtablissement": "81.21Z"
                },
                {
                    "dateFin": "2021-05-09",
                    "dateDebut": "2014-07-31",
                    "activitePrincipaleEtablissement": "81.30Z"
                },
                {
                    "dateFin": "2014-07-30",
                    "dateDebut": "2011-04-11",
                    "activitePrincipaleEtablissement": "81.30Z"
                },
                {
                    "dateFin": "2011-04-10",
                    "dateDebut": "2010-12-31",
                    "activitePrincipaleEtablissement": "81.30Z"
                },
                {
                    "dateFin": "2010-12-30",
                    "dateDebut": "2008-06-16",
                    "activitePrincipaleEtablissement": "81.30Z"
                },
                {
                    "dateFin": "2008-06-15",
                    "dateDebut": "2007-01-08",
                    "activitePrincipaleEtablissement": "01.4B"
                },
                {
                    "dateFin": "2007-01-07",
                    "dateDebut": "2005-01-01",
                    "activitePrincipaleEtablissement": "01.4B"
                },
                {
                    "dateFin": "2004-12-31",
                    "dateDebut": "1999-12-25",
                    "activitePrincipaleEtablissement": "01.4B"
                },
                {
                    "dateFin": "1999-12-24",
                    "dateDebut": "1999-04-19",
                    "activitePrincipaleEtablissement": null
                }
            ]
        }
    ]
}

Sortie csv : seules figurent les valeurs courantes des variables historisées (ici les APE 68.20B et 81.21Z)

siret,categorieJuridiqueUniteLegale,activitePrincipaleEtablissement
34513048800017,5710,68.20B
42267396200011,1000,81.21Z

Commentaires

Dès lors qu'on saisit une variable pour le paramètre champs, il faut saisir toutes les variables qu'on désire en sortie, à moins d'utiliser les champs groupés.
Le paramètre champs est disponible sur la console. Pour en savoir plus

Haut de page

---