Logo de l'API Sirene

API Sirene - Documentation des services

 Logo de l'Insee
retour au sommaire

Recherche sur les liens de succession : utilisation du paramètre q

Présentation du service

Permet de sélectionner les Siret pour lesquels une certaine variable a une valeur spécifique. La syntaxe est la suivante :

nomVariable:valeur
nomVariable doit correspondre exactement (casse comprise) à la variable de la réponse.
Toutes les variables peuvent être utilisées avec quelques subtilités pour les variables au format date.

Exemples

Recherche de l'établissement successeur du siret 31300257800042 :
https://api.insee.fr/api-sirene/3.11/siret/liensSuccession?q=siretEtablissementPredecesseur:31300257800042
Recherche de l'établissement prédécesseur du siret 31300257800042 :
https://api.insee.fr/api-sirene/3.11/siret/liensSuccession?q=siretEtablissementSuccesseur:31300257800042
Recherche de tous les liens de succession correspondant à des transferts de siège :
https://api.insee.fr/api-sirene/3.11/siret/liensSuccession?q=transfertSiege:true
Recherche de tous les liens de succession avec continuité économique :
https://api.insee.fr/api-sirene/3.11/siret/liensSuccession?q=continuiteEconomique:true

Requête par élimination

Il est possible de construire une requête en recherchant tous les établissements qui n’ont pas une caractéristique en utilisant le caractère « - ».
La syntaxe est la suivante :
-nomVariable:valeur

Requête sur plusieurs variables

Les mots clés AND et OR sont autorisés et peuvent être combinés avec des parenthèses ; sans parenthèses le AND prévaut sur le OR.
La syntaxe est la suivante :
nomVariable1:valeur1 OR nomVariable2:valeur2 nomVariable1:valeur1 AND nomVariable2:valeur2

Exemples

Recherche de tous les liens de succession avec l’établissement 53331016500022 comme successeur, pour lesquels il y a continuité économique :
https://api.insee.fr/api-sirene/3.11/siret/liensSuccession?q=siretEtablissementSuccesseur:53331016500022 AND continuiteEconomique:true 
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 1,
        "debut": 0,
        "nombre": 1
    },
    "liensSuccession": [
        {
            "siretEtablissementPredecesseur": "53331016500014",
            "siretEtablissementSuccesseur": "53331016500022",
            "dateLienSuccession": "2018-02-01",
            "transfertSiege": true,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2018-01-31T12:06:03.233"
        }
    ]
}
Recherche de tous les liens de succession où l’établissement 30075733300061 est soit prédécesseur, soit successeur :
https://api.insee.fr/api-sirene/3.11/siret/liensSuccession?q=siretEtablissementSuccesseur:30075733300061 OR siretEtablissementPredecesseur:30075733300061 
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 2,
        "debut": 0,
        "nombre": 2
    },
    "liensSuccession": [
        {
            "siretEtablissementPredecesseur": "30075733300053",
            "siretEtablissementSuccesseur": "30075733300061",
            "dateLienSuccession": "2004-06-01",
            "transfertSiege": false,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2005-11-26T11:54:32.532"
        },
        {
            "siretEtablissementPredecesseur": "30075733300061",
            "siretEtablissementSuccesseur": "30075733300053",
            "dateLienSuccession": "2006-05-02",
            "transfertSiege": false,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2006-05-09T11:41:15.423"
        }
    ]
}
Recherche de tous les successeurs des siret 30077813100023, 30078180400020, 30078425300019 et 30078719900037 :
https://api.insee.fr/api-sirene/3.11/siret/liensSuccession?q=siretEtablissementPredecesseur:30077813100023 OR siretEtablissementPredecesseur:30078180400020 OR siretEtablissementPredecesseur:30078425300019 OR siretEtablissementPredecesseur:30078719900037 
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 5,
        "debut": 0,
        "nombre": 5
    },
    "liensSuccession": [
        {
            "siretEtablissementPredecesseur": "30077813100023",
            "siretEtablissementSuccesseur": "30077813100031",
            "dateLienSuccession": "1997-02-07",
            "transfertSiege": false,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2005-11-26T11:54:33.224"
        },
        {
            "siretEtablissementPredecesseur": "30078180400020",
            "siretEtablissementSuccesseur": "41969416100011",
            "dateLienSuccession": "1998-07-01",
            "transfertSiege": false,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2005-11-26T11:54:33.224"
        },
        {
            "siretEtablissementPredecesseur": "30078425300019",
            "siretEtablissementSuccesseur": "45173921300010",
            "dateLienSuccession": "2004-01-01",
            "transfertSiege": false,
            "continuiteEconomique": false,
            "dateDernierTraitementLienSuccession": "2005-11-26T11:54:33.224"
        },
        {
            "siretEtablissementPredecesseur": "30078719900037",
            "siretEtablissementSuccesseur": "30078719900052",
            "dateLienSuccession": "1995-09-01",
            "transfertSiege": true,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2005-11-26T11:54:33.224"
        },
        {
            "siretEtablissementPredecesseur": "30078719900037",
            "siretEtablissementSuccesseur": "40226394100013",
            "dateLienSuccession": "1995-09-01",
            "transfertSiege": false,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2005-11-26T11:54:33.224"
        }
    ]
}
Recherche de tous les liens de succession impliquant les siret 30077813100023, 30078180400020, 30078425300019 et 30078719900037 :
https://api.insee.fr/api-sirene/3.11/siret/liensSuccession?q=siretEtablissementPredecesseur:30077813100023 OR siretEtablissementPredecesseur:30078180400020 OR siretEtablissementPredecesseur:30078425300019 OR siretEtablissementPredecesseur:30078719900037 OR siretEtablissementSuccesseur:30077813100023 OR siretEtablissementSuccesseur:30078180400020 OR siretEtablissementSuccesseur:30078425300019 OR siretEtablissementSuccesseur:30078719900037
Format Json 
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 8,
        "debut": 0,
        "nombre": 8
    },
    "liensSuccession": [
        {
            "siretEtablissementPredecesseur": "30077813100015",
            "siretEtablissementSuccesseur": "30077813100023",
            "dateLienSuccession": "1989-12-25",
            "transfertSiege": false,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2005-11-26T11:54:33.224"
        },
        {
            "siretEtablissementPredecesseur": "30077813100023",
            "siretEtablissementSuccesseur": "30077813100031",
            "dateLienSuccession": "1997-02-07",
            "transfertSiege": false,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2005-11-26T11:54:33.224"
        },
        {
            "siretEtablissementPredecesseur": "30078180400012",
            "siretEtablissementSuccesseur": "30078180400020",
            "dateLienSuccession": "1989-11-27",
            "transfertSiege": false,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2005-11-26T11:54:33.224"
        },
        {
            "siretEtablissementPredecesseur": "30078180400020",
            "siretEtablissementSuccesseur": "41969416100011",
            "dateLienSuccession": "1998-07-01",
            "transfertSiege": false,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2005-11-26T11:54:33.224"
        },
        {
            "siretEtablissementPredecesseur": "30078425300019",
            "siretEtablissementSuccesseur": "45173921300010",
            "dateLienSuccession": "2004-01-01",
            "transfertSiege": false,
            "continuiteEconomique": false,
            "dateDernierTraitementLienSuccession": "2005-11-26T11:54:33.224"
        },
        {
            "siretEtablissementPredecesseur": "30078719900037",
            "siretEtablissementSuccesseur": "30078719900052",
            "dateLienSuccession": "1995-09-01",
            "transfertSiege": true,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2005-11-26T11:54:33.224"
        },
        {
            "siretEtablissementPredecesseur": "30078719900037",
            "siretEtablissementSuccesseur": "40226394100013",
            "dateLienSuccession": "1995-09-01",
            "transfertSiege": false,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2005-11-26T11:54:33.224"
        },
        {
            "siretEtablissementPredecesseur": "30078719900045",
            "siretEtablissementSuccesseur": "30078719900037",
            "dateLienSuccession": "1994-10-11",
            "transfertSiege": true,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2005-11-26T11:54:33.224"
        }
    ]
}
Format csv :

siretEtablissementPredecesseur,siretEtablissementSuccesseur,dateLienSuccession,transfertSiege,continuiteEconomique,dateDernierTraitementLienSuccession 30077813100015,30077813100023,1989-12-25,false,true,2005-11-26T11:54:33.224 30077813100023,30077813100031,1997-02-07,false,true,2005-11-26T11:54:33.224 30078180400012,30078180400020,1989-11-27,false,true,2005-11-26T11:54:33.224 30078180400020,41969416100011,1998-07-01,false,true,2005-11-26T11:54:33.224 30078425300019,45173921300010,2004-01-01,false,false,2005-11-26T11:54:33.224 30078719900037,30078719900052,1995-09-01,true,true,2005-11-26T11:54:33.224 30078719900037,40226394100013,1995-09-01,false,true,2005-11-26T11:54:33.224 30078719900045,30078719900037,1994-10-11,true,true,2005-11-26T11:54:33.224

Requête sur les variables de type date

Les variables dates requêtables sont dateLienSuccession et dateDernierTraitementLienSuccession.
La syntaxe pour requêter sur les variables dates est la suivante :
Recherche sur l'année : variabledate:AAAA
Recherche sur le mois : variabledate:AAAA-MM
Recherche sur le jour : variabledate:AAAA-MM-JJ
Uniquement pour la variable dateDernierTraitementLienSuccession dont la précision est à la milliseconde :
Recherche sur l'heure : dateDernierTraitementLienSuccession:AAAA-MM-JJTHH
Recherche sur les minutes : dateDernierTraitementLienSuccession:"AAAA-MM-JJTHH:MM" ou dateDernierTraitementLienSuccession:AAAA-MM-JJTHH\:MM
Recherche sur les secondes : dateDernierTraitementLienSuccession:"AAAA-MM-JJTHH:MM:SS" ou dateDernierTraitementLienSuccession:AAAA-MM-JJTHH\:MM\:SS
Recherche sur les millisecondes : dateDernierTraitementLienSuccession:"AAAA-MM-JJTHH:MM:SS.MMM" ou dateDernierTraitementLienSuccession:AAAA-MM-JJTHH\:MM\:SS.MMM
L'utilisation des intervalles est également possible en combinant les possibilités (jour, mois, année et heure, minute, seconde pour les deux variables précitées).
Il n'y a pas besoin d'utiliser de caractères spéciaux pour les précisions à la minute ou à la seconde dans les intervalles :
variabledate:[2001 TO 2004-05] cherchera du 01/01/2001 inclus au 31/05/2004 inclus
variabledate:[2017 TO *] cherchera à partir du 01/01/2017
La syntaxe valable dans la V3.2 est toujours acceptée :
variabledate:"AAAA-MM-JJT00:00:00Z"
variabledate:[ʺAAAA-MM-JJT00:00:00Zʺ TO ʺAAAA-MM-JJT00:00:00Zʺ] etc.

Exemples

Recherche de tous les liens de succession avec une date d’effet au 2 février 2019 :
https://api.insee.fr/api-sirene/3.11/siret/liensSuccession?q=dateLienSuccession:2019-02-02

Sortie csv préférable (336 liens)

siretEtablissementPredecesseur,siretEtablissementSuccesseur,dateLienSuccession,transfertSiege,continuiteEconomique,dateDernierTraitementLienSuccession 32101034000032,32101034000040,2019-02-02,false,true,2019-04-04T15:03:01.524
33496796500024,33496796500032,2019-02-02,false,true,2019-01-30T14:58:21.263
33944436600043,33944436600050,2019-02-02,false,true,2019-03-14T14:58:34.623
34215051300030,42814728400023,2019-02-02,false,true,2018-11-22T11:13:49.732
34923592900065,34923592900123,2019-02-02,false,true,2019-04-18T09:07:40.653
35047561200023,35047561200031,2019-02-02,false,true,2019-02-19T14:37:36.263
35144551500049,35144551500056,2019-02-02,false,true,2019-05-24T15:32:54.263
38014014500109,38014014500117,2019-02-02,false,true,2019-03-11T03:33:26.263
38142611300019,38142611300027,2019-02-02,false,true,2019-03-11T03:39:30.263
38455201400019,84522134000019,2019-02-02,false,true,2019-02-07T14:16:16.263
38493187900025,38493187900033,2019-02-02,false,true,2019-03-01T19:34:30.263
39009922400052,39009922400060,2019-02-02,false,true,2019-03-29T08:40:21.263
39070033400027,84945806200015,2019-02-02,false,true,2019-03-27T09:36:32.263
39287806200018,39287806200026,2019-02-02,false,true,2020-05-29T10:19:34.263
39352432700029,39352432700037,2019-02-02,true,true,2021-10-11T10:55:19.263
39771806500055,39771806500063,2019-02-02,false,true,2019-02-26T12:58:25.263
39875487900029,39875487900037,2019-02-02,false,true,2019-11-18T11:16:40.263
40239847300056,40239847300064,2019-02-02,false,true,2019-04-26T10:31:11.263
40263245900036,40263245900044,2019-02-02,false,true,2019-03-05T07:54:05.263
40468650300057,40468650300065,2019-02-02,false,true,2019-03-18T14:51:02.263
...


Recherche de tous les liens de succession traités le 3 mars 2019 avant midi :
https://api.insee.fr/api-sirene/3.11/siret/liensSuccession?q=dateDernierTraitementLienSuccession:[2019-03-03T00:00:00 TO 2019-03-03T11:59:59] 
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 6,
        "debut": 0,
        "nombre": 6
    },
    "liensSuccession": [
        {
            "siretEtablissementPredecesseur": "35325411300049",
            "siretEtablissementSuccesseur": "35325411300056",
            "dateLienSuccession": "2018-11-02",
            "transfertSiege": false,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2019-03-03T03:32:07.263"
        },
        {
            "siretEtablissementPredecesseur": "49219173900035",
            "siretEtablissementSuccesseur": "49219173900043",
            "dateLienSuccession": "2019-02-12",
            "transfertSiege": false,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2019-03-03T03:32:06.623"
        },
        {
            "siretEtablissementPredecesseur": "80739129700023",
            "siretEtablissementSuccesseur": "80739129700031",
            "dateLienSuccession": "2018-12-01",
            "transfertSiege": false,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2019-03-03T03:31:55.763"
        },
        {
            "siretEtablissementPredecesseur": "81931043400017",
            "siretEtablissementSuccesseur": "84362344800019",
            "dateLienSuccession": "2018-12-14",
            "transfertSiege": false,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2019-03-03T03:31:52.663"
        },
        {
            "siretEtablissementPredecesseur": "82405527100012",
            "siretEtablissementSuccesseur": "82405527100020",
            "dateLienSuccession": "2018-12-17",
            "transfertSiege": false,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2019-03-03T03:31:49.267"
        },
        {
            "siretEtablissementPredecesseur": "83957016500010",
            "siretEtablissementSuccesseur": "83957016500028",
            "dateLienSuccession": "2019-01-09",
            "transfertSiege": false,
            "continuiteEconomique": true,
            "dateDernierTraitementLienSuccession": "2019-03-03T03:31:54.872"
        }

Commentaires

Le nombre maximum de siret séparés par des OR est de 68 en Json et 95 en csv pour la variable siretEtablissementPredecesseur ; il est de 70 en Json et 99 en csv pour la variable siretEtablissementSuccesseur.
La recherche des liens de succession est disponible sur la console. Pour en savoir plus

Haut de page