# 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. ## Endpoint - Method: `POST` - URL: `https://api.helpmyagent.com/v1/company/fr/changes` - Price: `0.015 USD` / call ## Machine discovery - llms.txt: https://helpmyagent.com/llms.txt - OpenAPI 3.1: https://api.helpmyagent.com/openapi.json - capabilities.json: https://helpmyagent.com/capabilities.json - MCP: https://helpmyagent.com/mcp - RFC 9727: https://helpmyagent.com/.well-known/api-catalog - pricing.json: https://helpmyagent.com/pricing.json - x402: https://helpmyagent.com/.well-known/x402 - x402-service.json: https://helpmyagent.com/.well-known/x402-service.json - Health status: https://helpmyagent.com/health ## x402 payment methods - USDC on `eip155:8453` - RLUSD on `xrpl:0` ## Coverage FR ## Use when - 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. ## Freshness ```json { "mode": "source_dependent" } ``` ## Sources - [INSEE — API Sirene 3.11](https://api.insee.fr/api-sirene/3.11) ## Input schema ```json { "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, "description": "Structured input parameters for the company/fr/changes API." } ``` ## Output schema ```json { "type": "object", "properties": { "identifier": { "type": "string", "description": "Identifier supplied for the request, echoed in normalized form when applicable." }, "identifier_type": { "type": "string", "enum": [ "siren", "siret" ], "description": "Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret)." }, "siren": { "type": "string", "description": "Normalized 9-digit French SIREN when available." }, "exists": { "type": "boolean", "description": "Whether the requested company or public record was found in the checked source." }, "since": { "type": [ "string", "null" ], "description": "Structured value returned for “since” as defined by this API contract." }, "until": { "type": [ "string", "null" ], "description": "Structured value returned for “until” as defined by this API contract." }, "offset": { "type": "integer", "description": "Structured value returned for “offset” as defined by this API contract." }, "next_offset": { "type": [ "integer", "null" ], "description": "Structured value returned for “next offset” as defined by this API contract." }, "limit": { "type": "integer", "description": "Structured value returned for “limit” as defined by this API contract." }, "total_count": { "type": "integer", "description": "Total number of matching records reported by the source or endpoint." }, "returned_count": { "type": "integer", "description": "Number of records included in this response." }, "truncated": { "type": "boolean", "description": "Whether additional matching records existed beyond the returned result limit." }, "changes": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": [ "string", "null" ], "description": "Structured value returned for “date” as defined by this API contract." }, "changed_fields": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string", "description": "Structured value returned for “field” as defined by this API contract." }, "value": { "type": [ "string", "boolean", "null" ], "description": "Structured value returned for “value” as defined by this API contract." } }, "required": [ "field", "value" ], "additionalProperties": false }, "description": "Structured value returned for “changed fields” as defined by this API contract." }, "state": { "type": "object", "properties": { "start_date": { "type": [ "string", "null" ], "description": "Structured value returned for “start date” as defined by this API contract." }, "end_date": { "type": [ "string", "null" ], "description": "Structured value returned for “end date” as defined by this API contract." }, "status": { "type": [ "string", "null" ], "enum": [ "active", "closed", null ], "description": "Normalized endpoint or source status. (allowed values: active, closed)." }, "name": { "type": [ "string", "null" ], "description": "Publicly available company, person, buyer or record name for this result." }, "usual_name": { "type": [ "string", "null" ], "description": "Structured value returned for “usual name” as defined by this API contract." }, "legal_form_code": { "type": [ "string", "null" ], "description": "Structured value returned for “legal form code” as defined by this API contract." }, "activity_code": { "type": [ "string", "null" ], "description": "Structured value returned for “activity code” as defined by this API contract." }, "activity_nomenclature": { "type": [ "string", "null" ], "description": "Structured value returned for “activity nomenclature” as defined by this API contract." }, "headquarters_nic": { "type": [ "string", "null" ], "description": "Structured value returned for “headquarters nic” as defined by this API contract." }, "is_employer": { "type": [ "boolean", "null" ], "description": "Structured value returned for “is employer” as defined by this API contract." }, "is_social_solidarity_economy": { "type": [ "boolean", "null" ], "description": "Structured value returned for “is social solidarity economy” as defined by this API contract." }, "is_mission_company": { "type": [ "boolean", "null" ], "description": "Structured value returned for “is mission company” as defined by this API contract." } }, "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, "description": "Structured value returned for “state” as defined by this API contract." } }, "required": [ "date", "changed_fields", "state" ], "additionalProperties": false }, "description": "Structured value returned for “changes” as defined by this API contract." }, "limitations": { "type": "array", "items": { "type": "string" }, "description": "Known interpretation, source-coverage or freshness limitations for this result." } }, "required": [ "identifier", "identifier_type", "siren", "exists", "since", "until", "offset", "next_offset", "limit", "total_count", "returned_count", "truncated", "changes" ], "additionalProperties": false, "description": "Structured result returned by the company/fr/changes API." } ``` ## Request example ```json { "identifier": "356000000", "since": "2025-01-01", "offset": 0, "limit": 100 } ``` ## Billing policy ```json { "charge_on": "valid_result", "no_charge_on_error": true, "no_charge_on_empty_result": true } ```