helpmyagent.com
FR Connect my AI
☰

French Establishment Successions

Returns official Sirene predecessor and successor links for a French establishment, with effective date, headquarters-transfer flag and economic-continuity flag.

0.010 USD

Charged on valid result · Empty result not charged · Errors not charged

When to use this API?

Use for

  • You need official predecessor or successor establishment links for a French SIRET.

Avoid when

  • You only need the current establishments of a company; use company/fr/establishments.

Limitations

  • Succession links are declaration-based and INSEE explicitly states that not every real-world succession is necessarily known.
  • Predecessor and successor cursors are independent and must only be reused for the same SIRET and direction.

Sources and provenance

INSEE — API Sirene 3.11

api.insee.fr

Input / Output schemas

Simplified endpoint contracts. The complete schema remains available in OpenAPI 3.1.

OpenAPI 3.1 →

Input schema
siretstring

Required · 14-digit French SIRET

limitinteger

Maximum predecessor and successor links per direction, up to 100

predecessors_cursorstring

Opaque cursor returned by predecessors_next_cursor; omit on the first call

successors_cursorstring

Opaque cursor returned by successors_next_cursor; omit on the first call

View full JSON Schema
{
    "type": "object",
    "properties": {
        "siret": {
            "type": "string",
            "pattern": "^[0-9]{14}$",
            "description": "14-digit French SIRET"
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 50,
            "description": "Maximum predecessor and successor links per direction, up to 100"
        },
        "predecessors_cursor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 4096,
            "default": "*",
            "description": "Opaque cursor returned by predecessors_next_cursor; omit on the first call"
        },
        "successors_cursor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 4096,
            "default": "*",
            "description": "Opaque cursor returned by successors_next_cursor; omit on the first call"
        }
    },
    "required": [
        "siret"
    ],
    "additionalProperties": false
}
Output schema
siretstring

Required

sirenstring

Required

predecessors_countinteger

Required

successors_countinteger

Required

predecessors_returned_countinteger

Required

successors_returned_countinteger

Required

predecessors_cursorstring

Required

successors_cursorstring

Required

predecessors_next_cursorstring | null

Required

successors_next_cursorstring | null

Required

predecessors_truncatedboolean

Required

successors_truncatedboolean

Required

predecessorsarray

Required

successorsarray

Required

limitationsarray

View full JSON Schema
{
    "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
}