helpmyagent.com
FR Connect my AI
☰

French Company Events

Returns the latest normalized public BODACC events for a French company from a SIREN or SIRET.

0.010 USD

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

When to use this API?

Use for

  • You need recent normalized BODACC events for a French company, such as filings, modifications, collective proceedings or deregistrations.
  • You need an event timeline filtered from an optional publication date.

Avoid when

  • You need an interpreted legal-risk level rather than raw normalized events; use company/fr/risk.
  • You only need current administrative profile fields; use company/fr/profile.

Limitations

  • The result reflects BODACC records available through the public dataset and the requested limit/date filter.
  • Normalized events are factual source records and do not constitute legal advice or a risk score.

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

limitinteger

Maximum number of normalized BODACC events to return

sincestring

Minimum included BODACC publication date in YYYY-MM-DD format

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"
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 20,
            "description": "Maximum number of normalized BODACC events to return"
        },
        "since": {
            "type": "string",
            "format": "date",
            "description": "Minimum included BODACC publication date in YYYY-MM-DD format"
        }
    },
    "required": [
        "identifier"
    ],
    "additionalProperties": false
}
Output schema
identifierstring

Required

identifier_typestring

Required

existsboolean

Required

sirenstring | null

Required

namestring | null

Required

total_countinteger

Required

returned_countinteger

Required

truncatedboolean

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"
            ]
        },
        "total_count": {
            "type": "integer"
        },
        "returned_count": {
            "type": "integer"
        },
        "truncated": {
            "type": "boolean"
        },
        "latest_event": {
            "type": [
                "object",
                "null"
            ]
        },
        "events": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "collective_procedure",
                            "radiation",
                            "accounts_filing",
                            "act",
                            "modification",
                            "other"
                        ]
                    },
                    "publication_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "event_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "family_code": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "family": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "notice_type": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "title": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "tribunal": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "department": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "city": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "url": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                }
            }
        }
    },
    "required": [
        "identifier",
        "identifier_type",
        "exists",
        "siren",
        "name",
        "total_count",
        "returned_count",
        "truncated",
        "latest_event",
        "events"
    ],
    "additionalProperties": false
}

Example queries

What are the latest BODACC events for SIREN 356000000?
Show company filings published since 2026-01-01.
Has this company had a recent modification or deregistration notice?