helpmyagent.com
EN Brancher mon IA
☰

Successions d’un établissement français

Retourne les liens officiels Sirene de prédécesseurs et successeurs d’un établissement français, avec date d’effet, transfert de siège et continuité économique.

0.010 USD

Facturation sur résultat valide · Résultat vide non facturé · Erreur non facturée

Quand utiliser cette API ?

À utiliser pour

  • Vous recherchez les liens officiels de prédécesseurs ou successeurs d’un établissement français.

À éviter quand

  • Vous avez seulement besoin des établissements actuels d’une entreprise ; utilisez company/fr/establishments.

Limitations

  • Les liens de succession sont déclaratifs et l’INSEE précise que toutes les successions réelles ne sont pas nécessairement connues.
  • Les curseurs prédécesseurs et successeurs sont indépendants et doivent uniquement être réutilisés pour le même SIRET et la même direction.

Sources et provenance

INSEE — API Sirene 3.11

api.insee.fr

Schémas Input / Output

Contrats simplifiés de l’endpoint. Le schéma complet reste disponible dans OpenAPI 3.1.

OpenAPI 3.1 →

Input schema
siretstring

Obligatoire · SIRET français à 14 chiffres

limitinteger

Nombre maximal de liens par direction, jusqu’à 100

predecessors_cursorstring

Curseur opaque retourné dans predecessors_next_cursor ; à omettre au premier appel

successors_cursorstring

Curseur opaque retourné dans successors_next_cursor ; à omettre au premier appel

Voir le JSON Schema complet
{
    "type": "object",
    "properties": {
        "siret": {
            "type": "string",
            "pattern": "^[0-9]{14}$",
            "description": "SIRET français à 14 chiffres"
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 50,
            "description": "Nombre maximal de liens par direction, jusqu’à 100"
        },
        "predecessors_cursor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 4096,
            "default": "*",
            "description": "Curseur opaque retourné dans predecessors_next_cursor ; à omettre au premier appel"
        },
        "successors_cursor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 4096,
            "default": "*",
            "description": "Curseur opaque retourné dans successors_next_cursor ; à omettre au premier appel"
        }
    },
    "required": [
        "siret"
    ],
    "additionalProperties": false
}
Output schema
siretstring

Obligatoire

sirenstring

Obligatoire

predecessors_countinteger

Obligatoire

successors_countinteger

Obligatoire

predecessors_returned_countinteger

Obligatoire

successors_returned_countinteger

Obligatoire

predecessors_cursorstring

Obligatoire

successors_cursorstring

Obligatoire

predecessors_next_cursorstring | null

Obligatoire

successors_next_cursorstring | null

Obligatoire

predecessors_truncatedboolean

Obligatoire

successors_truncatedboolean

Obligatoire

predecessorsarray

Obligatoire

successorsarray

Obligatoire

limitationsarray

Voir le JSON Schema complet
{
    "type": "object",
    "properties": {
        "siret": {
            "type": "string"
        },
        "siren": {
            "type": "string"
        },
        "predecessors_count": {
            "type": "integer"
        },
        "successors_count": {
            "type": "integer"
        },
        "predecessors_returned_count": {
            "type": "integer"
        },
        "successors_returned_count": {
            "type": "integer"
        },
        "predecessors_cursor": {
            "type": "string"
        },
        "successors_cursor": {
            "type": "string"
        },
        "predecessors_next_cursor": {
            "type": [
                "string",
                "null"
            ]
        },
        "successors_next_cursor": {
            "type": [
                "string",
                "null"
            ]
        },
        "predecessors_truncated": {
            "type": "boolean"
        },
        "successors_truncated": {
            "type": "boolean"
        },
        "predecessors": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "siret": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "effective_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "headquarters_transfer": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "economic_continuity": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "last_processed_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "siret",
                    "effective_date",
                    "headquarters_transfer",
                    "economic_continuity",
                    "last_processed_at"
                ],
                "additionalProperties": false
            }
        },
        "successors": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "siret": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "effective_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "headquarters_transfer": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "economic_continuity": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "last_processed_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "siret",
                    "effective_date",
                    "headquarters_transfer",
                    "economic_continuity",
                    "last_processed_at"
                ],
                "additionalProperties": false
            }
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "required": [
        "siret",
        "siren",
        "predecessors_count",
        "successors_count",
        "predecessors_returned_count",
        "successors_returned_count",
        "predecessors_cursor",
        "successors_cursor",
        "predecessors_next_cursor",
        "successors_next_cursor",
        "predecessors_truncated",
        "successors_truncated",
        "predecessors",
        "successors"
    ],
    "additionalProperties": false
}