# French Establishment Successions

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

## Endpoint

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

## 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": {
        "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,
    "description": "Structured input parameters for the company/fr/successions API."
}
```

## Output schema

```json
{
    "type": "object",
    "properties": {
        "siret": {
            "type": "string",
            "description": "Normalized 14-digit French SIRET when available."
        },
        "siren": {
            "type": "string",
            "description": "Normalized 9-digit French SIREN when available."
        },
        "predecessors_count": {
            "type": "integer",
            "description": "Structured value returned for “predecessors count” as defined by this API contract."
        },
        "successors_count": {
            "type": "integer",
            "description": "Structured value returned for “successors count” as defined by this API contract."
        },
        "predecessors_returned_count": {
            "type": "integer",
            "description": "Structured value returned for “predecessors returned count” as defined by this API contract."
        },
        "successors_returned_count": {
            "type": "integer",
            "description": "Structured value returned for “successors returned count” as defined by this API contract."
        },
        "predecessors_cursor": {
            "type": "string",
            "description": "Structured value returned for “predecessors cursor” as defined by this API contract."
        },
        "successors_cursor": {
            "type": "string",
            "description": "Structured value returned for “successors cursor” as defined by this API contract."
        },
        "predecessors_next_cursor": {
            "type": [
                "string",
                "null"
            ],
            "description": "Structured value returned for “predecessors next cursor” as defined by this API contract."
        },
        "successors_next_cursor": {
            "type": [
                "string",
                "null"
            ],
            "description": "Structured value returned for “successors next cursor” as defined by this API contract."
        },
        "predecessors_truncated": {
            "type": "boolean",
            "description": "Structured value returned for “predecessors truncated” as defined by this API contract."
        },
        "successors_truncated": {
            "type": "boolean",
            "description": "Structured value returned for “successors truncated” as defined by this API contract."
        },
        "predecessors": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "siret": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Normalized 14-digit French SIRET when available."
                    },
                    "effective_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “effective date” as defined by this API contract."
                    },
                    "headquarters_transfer": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "Structured value returned for “headquarters transfer” as defined by this API contract."
                    },
                    "economic_continuity": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "Structured value returned for “economic continuity” 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."
                    }
                },
                "required": [
                    "siret",
                    "effective_date",
                    "headquarters_transfer",
                    "economic_continuity",
                    "last_processed_at"
                ],
                "additionalProperties": false
            },
            "description": "Structured value returned for “predecessors” as defined by this API contract."
        },
        "successors": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "siret": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Normalized 14-digit French SIRET when available."
                    },
                    "effective_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “effective date” as defined by this API contract."
                    },
                    "headquarters_transfer": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "Structured value returned for “headquarters transfer” as defined by this API contract."
                    },
                    "economic_continuity": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "Structured value returned for “economic continuity” 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."
                    }
                },
                "required": [
                    "siret",
                    "effective_date",
                    "headquarters_transfer",
                    "economic_continuity",
                    "last_processed_at"
                ],
                "additionalProperties": false
            },
            "description": "Structured value returned for “successors” as defined by this API contract."
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Known interpretation, source-coverage or freshness limitations for this result."
        }
    },
    "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,
    "description": "Structured result returned by the company/fr/successions API."
}
```

## Request example

```json
{
    "siret": "39860733300042",
    "limit": 50
}
```

## Billing policy

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