# French Industrial Installation Risk

Finds public ICPE, Seveso and IED installation signals across the company establishments available from SIRENE, with explicit coverage indicators.

## Endpoint

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

- Find public ICPE, Seveso and IED installation signals across the known establishments of a French company.

## Avoid when

- You only need the company establishment list; use company/fr/establishments.

## Limitations

- Coverage is explicit and can be partial for very large companies or when public sources are unavailable.

## Example queries

- Does this company operate any public ICPE, Seveso or IED sites?

## Freshness

```json
{
    "mode": "source_dependent"
}
```

## Sources

- [INSEE API Sirene](https://api.insee.fr/api-sirene/3.11)
- [Géorisques installations classées](https://www.georisques.gouv.fr)

## Input schema

```json
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "pattern": "^[0-9]{9}([0-9]{5})?$",
            "description": "French company identifier: 9-digit SIREN or 14-digit SIRET."
        }
    },
    "additionalProperties": false,
    "required": [
        "identifier"
    ],
    "description": "Structured input parameters for the company/fr/industrial-risk API."
}
```

## Output schema

```json
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "description": "Identifier supplied for the request, echoed in normalized form when applicable."
        },
        "exists": {
            "type": "boolean",
            "description": "Whether the requested company or public record was found in the checked source."
        },
        "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."
        },
        "headquarters_commune_code": {
            "type": [
                "string",
                "null"
            ],
            "description": "Structured value returned for “headquarters commune code” as defined by this API contract."
        },
        "source_status": {
            "type": "string",
            "enum": [
                "ok",
                "partial",
                "unavailable",
                "not_queried"
            ],
            "description": "Availability status of the relevant upstream public source. (allowed values: ok, partial, unavailable, not_queried)."
        },
        "establishments_total": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Structured value returned for “establishments total” as defined by this API contract."
        },
        "establishments_scanned": {
            "type": "integer",
            "description": "Structured value returned for “establishments scanned” as defined by this API contract."
        },
        "communes_total": {
            "type": "integer",
            "description": "Structured value returned for “communes total” as defined by this API contract."
        },
        "communes_scanned": {
            "type": "integer",
            "description": "Structured value returned for “communes scanned” as defined by this API contract."
        },
        "installation_count": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Structured value returned for “installation count” as defined by this API contract."
        },
        "installations": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "code_aiot": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “code aiot” as defined by this API contract."
                    },
                    "name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Publicly available company, person, buyer or record name for this result."
                    },
                    "siret": {
                        "type": "string",
                        "description": "Normalized 14-digit French SIRET when available."
                    },
                    "address": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “address” as defined by this API contract."
                    },
                    "city": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “city” as defined by this API contract."
                    },
                    "status": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Normalized endpoint or source status."
                    },
                    "regime": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “regime” as defined by this API contract."
                    },
                    "seveso": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “seveso” as defined by this API contract."
                    },
                    "ied": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "Structured value returned for “ied” as defined by this API contract."
                    }
                },
                "additionalProperties": false,
                "required": [
                    "code_aiot",
                    "name",
                    "siret",
                    "address",
                    "city",
                    "status",
                    "regime",
                    "seveso",
                    "ied"
                ]
            },
            "description": "Structured value returned for “installations” as defined by this API contract."
        },
        "coverage_complete": {
            "type": "boolean",
            "description": "Whether the checked public-source coverage was sufficient for the endpoint’s stated scope."
        },
        "checked_at": {
            "type": "string",
            "description": "UTC timestamp at which HelpMyAgent performed the check."
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Known interpretation, source-coverage or freshness limitations for this result."
        }
    },
    "additionalProperties": false,
    "required": [
        "identifier",
        "exists",
        "siren",
        "name",
        "headquarters_commune_code",
        "source_status",
        "establishments_total",
        "establishments_scanned",
        "communes_total",
        "communes_scanned",
        "installation_count",
        "installations",
        "coverage_complete",
        "checked_at"
    ],
    "description": "Structured result returned by the company/fr/industrial-risk API."
}
```

## Billing policy

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