INSEE — API Sirene 3.11
api.insee.frFrench Company Sirene History
Returns the historized Sirene periods of a French legal unit, including status, name, legal form, activity, headquarters NIC and explicit change flags.
0.015 USD
Charged on valid result · Empty result not charged · Errors not charged
When to use this API?
Use for
- You need the official Sirene period history for a French legal unit.
Avoid when
- You need a BODACC event timeline; use company/fr/events.
Limitations
- History reflects Sirene historized variables and should not be interpreted as a complete legal or commercial event history.
Sources and provenance
Input / Output schemas
Simplified endpoint contracts. The complete schema remains available in OpenAPI 3.1.
Input schema
identifierstringRequired · 9-digit SIREN or 14-digit SIRET; a SIRET is normalized to its SIREN
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; a SIRET is normalized to its SIREN"
}
},
"required": [
"identifier"
],
"additionalProperties": false
}Output schema
identifierstringRequired
identifier_typestringRequired
sirenstringRequired
existsbooleanRequired
currentobject | nullRequired
periods_countintegerRequired
periodsarrayRequired
View full JSON Schema
{
"type": "object",
"properties": {
"identifier": {
"type": "string"
},
"identifier_type": {
"type": "string",
"enum": [
"siren",
"siret"
]
},
"siren": {
"type": "string"
},
"exists": {
"type": "boolean"
},
"current": {
"type": [
"object",
"null"
],
"properties": {
"siren": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"string",
"null"
],
"enum": [
"active",
"closed",
null
]
},
"creation_date": {
"type": [
"string",
"null"
]
},
"closure_date": {
"type": [
"string",
"null"
]
},
"activity_code": {
"type": [
"string",
"null"
]
},
"legal_form_code": {
"type": [
"string",
"null"
]
},
"employee_band_code": {
"type": [
"string",
"null"
]
},
"employee_band_year": {
"type": [
"string",
"null"
]
},
"company_category": {
"type": [
"string",
"null"
]
},
"last_processed_at": {
"type": [
"string",
"null"
]
},
"periods_count": {
"type": [
"integer",
"null"
]
}
},
"required": [
"siren",
"name",
"status",
"creation_date",
"closure_date",
"activity_code",
"legal_form_code",
"employee_band_code",
"employee_band_year",
"company_category",
"last_processed_at",
"periods_count"
],
"additionalProperties": false
},
"periods_count": {
"type": "integer"
},
"periods": {
"type": "array",
"items": {
"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"
]
},
"changed_fields": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"value": {
"type": [
"string",
"boolean",
"null"
]
}
},
"required": [
"field",
"value"
],
"additionalProperties": false
}
}
},
"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",
"changed_fields"
],
"additionalProperties": false
}
}
},
"required": [
"identifier",
"identifier_type",
"siren",
"exists",
"current",
"periods_count",
"periods"
],
"additionalProperties": false
}