helpmyagent.com
FR Connect my AI
☰

French Company Changes

Returns explicit historized Sirene change flags for a French legal unit, with the normalized state that became effective on each change date.

0.015 USD

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

When to use this API?

Use for

  • You need explainable administrative changes recorded in historized Sirene periods for one company.

Avoid when

  • You need BODACC legal notices; use company/fr/events or company/fr/legal-announcements-search.

Limitations

  • Only change flags explicitly provided by Sirene are returned; business events are not inferred.
  • Sirene exposes one change indicator for the three usual-denomination fields; when it changes, the post-change values of all three fields are returned.

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
identifierstring

Required · 9-digit SIREN or 14-digit SIRET

sincestring

Optional inclusive change start date

untilstring

Optional inclusive change end date

offsetinteger

Zero-based offset within the filtered change list; use next_offset to continue

limitinteger

Maximum changes to return, up to 100

View full JSON Schema
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "pattern": "^[0-9]{9}([0-9]{5})?$",
            "description": "9-digit SIREN or 14-digit SIRET"
        },
        "since": {
            "type": "string",
            "format": "date",
            "description": "Optional inclusive change start date"
        },
        "until": {
            "type": "string",
            "format": "date",
            "description": "Optional inclusive change end date"
        },
        "offset": {
            "type": "integer",
            "minimum": 0,
            "default": 0,
            "description": "Zero-based offset within the filtered change list; use next_offset to continue"
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 100,
            "description": "Maximum changes to return, up to 100"
        }
    },
    "required": [
        "identifier"
    ],
    "additionalProperties": false
}
Output schema
identifierstring

Required

identifier_typestring

Required

sirenstring

Required

existsboolean

Required

sincestring | null

Required

untilstring | null

Required

offsetinteger

Required

next_offsetinteger | null

Required

limitinteger

Required

total_countinteger

Required

returned_countinteger

Required

truncatedboolean

Required

changesarray

Required

limitationsarray

View full JSON Schema
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string"
        },
        "identifier_type": {
            "type": "string",
            "enum": [
                "siren",
                "siret"
            ]
        },
        "siren": {
            "type": "string"
        },
        "exists": {
            "type": "boolean"
        },
        "since": {
            "type": [
                "string",
                "null"
            ]
        },
        "until": {
            "type": [
                "string",
                "null"
            ]
        },
        "offset": {
            "type": "integer"
        },
        "next_offset": {
            "type": [
                "integer",
                "null"
            ]
        },
        "limit": {
            "type": "integer"
        },
        "total_count": {
            "type": "integer"
        },
        "returned_count": {
            "type": "integer"
        },
        "truncated": {
            "type": "boolean"
        },
        "changes": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "changed_fields": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "field": {
                                    "type": "string"
                                },
                                "value": {
                                    "type": [
                                        "string",
                                        "boolean",
                                        "null"
                                    ]
                                }
                            },
                            "required": [
                                "field",
                                "value"
                            ],
                            "additionalProperties": false
                        }
                    },
                    "state": {
                        "type": "object",
                        "properties": {
                            "start_date": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "end_date": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "status": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "active",
                                    "closed",
                                    null
                                ]
                            },
                            "name": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "usual_name": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "legal_form_code": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "activity_code": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "activity_nomenclature": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "headquarters_nic": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "is_employer": {
                                "type": [
                                    "boolean",
                                    "null"
                                ]
                            },
                            "is_social_solidarity_economy": {
                                "type": [
                                    "boolean",
                                    "null"
                                ]
                            },
                            "is_mission_company": {
                                "type": [
                                    "boolean",
                                    "null"
                                ]
                            }
                        },
                        "required": [
                            "start_date",
                            "end_date",
                            "status",
                            "name",
                            "usual_name",
                            "legal_form_code",
                            "activity_code",
                            "activity_nomenclature",
                            "headquarters_nic",
                            "is_employer",
                            "is_social_solidarity_economy",
                            "is_mission_company"
                        ],
                        "additionalProperties": false
                    }
                },
                "required": [
                    "date",
                    "changed_fields",
                    "state"
                ],
                "additionalProperties": false
            }
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "required": [
        "identifier",
        "identifier_type",
        "siren",
        "exists",
        "since",
        "until",
        "offset",
        "next_offset",
        "limit",
        "total_count",
        "returned_count",
        "truncated",
        "changes"
    ],
    "additionalProperties": false
}