helpmyagent.com
FR Connect my AI
☰

French Company Legal Risk

Detects public legal-risk signals for a French company from company status and BODACC notices, including insolvency proceedings and deregistrations. This is not a credit score.

0.010 USD

Charged on valid result · Empty result not charged · Errors not charged

When to use this API?

Use for

  • You need explainable public legal-risk signals for a French company, including insolvency proceedings, deregistrations and administrative closure.
  • You need a normalized low, warning, high or unknown legal-risk level backed by public events.

Avoid when

  • You need a credit score, probability of default, payment behavior or bank-grade solvency assessment.
  • You need sanctions or regulatory blacklist screening; use company/fr/compliance.

Limitations

  • The BODACC analysis uses a 10-year lookback and reports when source coverage is insufficient to conclude.
  • This is a public legal-risk signal service, not a credit score or legal opinion.

Sources and provenance

API Recherche d'entreprises

recherche-entreprises.api.gouv.fr

BODACC Open Data

bodacc-datadila.opendatasoft.com

Input / Output schemas

Simplified endpoint contracts. The complete schema remains available in OpenAPI 3.1.

OpenAPI 3.1 →

Input schema
identifierstring

Required · 9-digit SIREN or 14-digit SIRET

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"
        }
    },
    "required": [
        "identifier"
    ],
    "additionalProperties": false
}
Output schema
identifierstring

Required

identifier_typestring

Required

existsboolean

Required

sirenstring | null

Required

namestring | null

Required

company_statusstring | null

Required

risk_levelstring | null

Required

assessment_basisstring

Required

lookback_yearsinteger

Required

coverage_completeboolean | null

Required

signalsobject

Required

latest_eventobject | null

Required

eventsarray

Required

View full JSON Schema
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string"
        },
        "identifier_type": {
            "type": "string",
            "enum": [
                "siren",
                "siret"
            ]
        },
        "exists": {
            "type": "boolean"
        },
        "siren": {
            "type": [
                "string",
                "null"
            ]
        },
        "name": {
            "type": [
                "string",
                "null"
            ]
        },
        "company_status": {
            "type": [
                "string",
                "null"
            ]
        },
        "risk_level": {
            "type": [
                "string",
                "null"
            ],
            "enum": [
                "low",
                "warning",
                "high",
                "unknown",
                null
            ]
        },
        "assessment_basis": {
            "type": "string"
        },
        "lookback_years": {
            "type": "integer"
        },
        "coverage_complete": {
            "type": [
                "boolean",
                "null"
            ]
        },
        "signals": {
            "type": "object",
            "properties": {
                "company_closed": {
                    "type": [
                        "boolean",
                        "null"
                    ]
                },
                "collective_procedure_events": {
                    "type": "integer"
                },
                "radiation_events": {
                    "type": "integer"
                }
            },
            "required": [
                "company_closed",
                "collective_procedure_events",
                "radiation_events"
            ],
            "additionalProperties": false
        },
        "latest_event": {
            "type": [
                "object",
                "null"
            ]
        },
        "events": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "collective_procedure",
                            "radiation"
                        ]
                    },
                    "publication_date": {
                        "type": "string"
                    },
                    "decision_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "family": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "decision_type": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "tribunal": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "url": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                }
            }
        }
    },
    "required": [
        "identifier",
        "identifier_type",
        "exists",
        "siren",
        "name",
        "company_status",
        "risk_level",
        "assessment_basis",
        "lookback_years",
        "coverage_complete",
        "signals",
        "latest_event",
        "events"
    ],
    "additionalProperties": false
}

Example queries

Does this French company show public insolvency risk signals?
Has SIREN 356000000 been deregistered or subject to collective proceedings?
Explain the public legal-risk level for this company.