# French 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.

## Endpoint

- Method: `POST`
- URL: `https://api.helpmyagent.com/v1/company/fr/history`
- 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 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.

## 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; a SIRET is normalized to its SIREN"
        }
    },
    "required": [
        "identifier"
    ],
    "additionalProperties": false,
    "description": "Structured input parameters for the company/fr/history 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."
        },
        "current": {
            "type": [
                "object",
                "null"
            ],
            "properties": {
                "siren": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Normalized 9-digit French SIREN when available."
                },
                "name": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Publicly available company, person, buyer or record name for this result."
                },
                "status": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "enum": [
                        "active",
                        "closed",
                        null
                    ],
                    "description": "Normalized endpoint or source status. (allowed values: active, closed)."
                },
                "creation_date": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “creation date” as defined by this API contract."
                },
                "closure_date": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “closure date” as defined by this API contract."
                },
                "activity_code": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “activity code” 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."
                },
                "employee_band_code": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “employee band code” as defined by this API contract."
                },
                "employee_band_year": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “employee band year” as defined by this API contract."
                },
                "company_category": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “company category” as defined by this API contract."
                },
                "last_processed_at": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “last processed at” as defined by this API contract."
                },
                "periods_count": {
                    "type": [
                        "integer",
                        "null"
                    ],
                    "description": "Structured value returned for “periods count” as defined by this API contract."
                }
            },
            "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,
            "description": "Structured value returned for “current” as defined by this API contract."
        },
        "periods_count": {
            "type": "integer",
            "description": "Structured value returned for “periods count” as defined by this API contract."
        },
        "periods": {
            "type": "array",
            "items": {
                "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."
                    },
                    "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."
                    }
                },
                "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
            },
            "description": "Structured value returned for “periods” as defined by this API contract."
        }
    },
    "required": [
        "identifier",
        "identifier_type",
        "siren",
        "exists",
        "current",
        "periods_count",
        "periods"
    ],
    "additionalProperties": false,
    "description": "Structured result returned by the company/fr/history API."
}
```

## Request example

```json
{
    "identifier": "356000000"
}
```

## Billing policy

```json
{
    "charge_on": "valid_result",
    "no_charge_on_error": true,
    "no_charge_on_empty_result": true
}
```