helpmyagent.com
FR Explore APIs

French Company Events

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

POST https://api.helpmyagent.com/v1/company/fr/events
$ 0.010 $ / callcharged on valid result · empty result not charged · errors not charged
FRCoverageFR
DBDocumented sources2
{ }Structured outputJSON
⌁REST + MCPx402
$Pay per call0.010 $

When should you use this API?

Use cases and limitations are published with the API so humans and agents can integrate it correctly.

Use when

  • 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

Sources published for this endpoint are shown directly with their original link.

API Recherche d'entreprises

recherche-entreprises.api.gouv.fr

View source ↗

Stored real response

This snapshot is served from published database data without executing the paid API.

View full JSON →
company/fr/eventsStored demo
Request
{
    "identifier": "356000000",
    "limit": 10
}
Stored response
{
    "identifier": "356000000",
    "identifier_type": "siren",
    "exists": true,
    "siren": "356000000",
    "name": "LA POSTE",
    "total_count": 102,
    "returned_count": 10,
    "truncated": true,
    "latest_event": {
        "id": "B202601601781",
        "type": "modification",
        "publication_date": "2026-08-23",
        "event_date": null,
        "family_code": "modification",
        "family": "Modifications diverses",
        "notice_type": "Avis initial",
        "title": "Modifications diverses",
        "description": "modification survenue sur le capital (augmentation)",
        "tribunal": "Greffe du Tribunal des Activités Economiques de Paris",
        "department": "75",
        "city": "Paris",
        "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:B202601601781"
    },
    "events": [
        {
            "id": "B202601601781",
            "type": "modification",
            "publication_date": "2026-08-23",
            "event_date": null,
            "family_code": "modification",
            "family": "Modifications diverses",
            "notice_type": "Avis initial",
            "title": "Modifications diverses",
            "description": "modification survenue sur le capital (augmentation)",
            "tribunal": "Greffe du Tribunal des Activités Economiques de Paris",
            "department": "75",
            "city": "Paris",
            "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:B202601601781"
        },
        {
            "id": "C2026013311905",
            "type": "accounts_filing",
            "publication_date": "2026-07-16",
            "event_date": "2025-12-31",
            "family_code": "dpc",
            "family": "Dépôts des comptes",
            "notice_type": "Avis initial",
            "title": "Comptes consolidés et rapports",
            "description": null,
            "tribunal": "Greffe du Tribunal des Activités Economiques de paris",
            "department": "75",
            "city": "Paris",
            "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:C2026013311905"
        },
        {
            "id": "C2026013210056",
            "type": "accounts_filing",
            "publication_date": "2026-07-14",
            "event_date": "2025-12-31",
            "family_code": "dpc",
            "family": "Dépôts des comptes",
            "notice_type": "Avis initial",
            "title": "Comptes annuels et rapports",
            "description": null,
            "tribunal": "Greffe du Tribunal des Activités Economiques de paris",
            "department": "75",
            "city": "Paris",
            "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:C2026013210056"
        },
        {
            "id": "B202601312908",
            "type": "modification",
            "publication_date": "2026-07-12",
            "event_date": null,
            "family_code": "modification",
            "family": "Modifications diverses",
            "notice_type": "Avis initial",
            "title": "Modifications diverses",
            "description": "modification survenue sur l'administration",
            "tribunal": "Greffe du Tribunal des Activités Economiques de Paris",
            "department": "75",
            "city": "Paris",
            "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:B202601312908"
        },
        {
            "id": "A202601291529",
            "type": "act",
            "publication_date": "2026-07-09",
            "event_date": null,
            "family_code": "vente",
            "family": "Ventes et cessions",
            "notice_type": "Avis initial",
            "title": "Ventes et cessions",
            "description": null,
            "tribunal": "Greffe du Tribunal des Activités Economiques de Paris",
            "department": "75",
            "city": "Paris",
            "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:A202601291529"
        },
        {
            "id": "C202601254590",
            "type": "accounts_filing",
            "publication_date": "2026-07-03",
            "event_date": "2025-12-31",
            "family_code": "dpc",
            "family": "Dépôts des comptes",
            "notice_type": "Avis initial",
            "title": "Comptes annuels et rapports",
            "description": null,
            "tribunal": "Greffe du Tribunal des Activités Economiques de paris",
            "department": "75",
            "city": "Paris",
            "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:C202601254590"
        },
        {
            "id": "C202601254591",
            "type": "accounts_filing",
            "publication_date": "2026-07-03",
            "event_date": "2025-12-31",
            "family_code": "dpc",
            "family": "Dépôts des comptes",
            "notice_type": "Avis initial",
            "title": "Comptes consolidés et rapports",
            "description": null,
            "tribunal": "Greffe du Tribunal des Activités Economiques de paris",
            "department": "75",
            "city": "Paris",
            "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:C202601254591"
        },
        {
            "id": "B202600985927",
            "type": "modification",
            "publication_date": "2026-05-26",
            "event_date": null,
            "family_code": "modification",
            "family": "Modifications diverses",
            "notice_type": "Avis initial",
            "title": "Modifications diverses",
            "description": "modification survenue sur l'administration",
            "tribunal": "Greffe du Tribunal des Activités Economiques de Paris",
            "department": "75",
            "city": "Paris",
            "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:B202600985927"
        },
        {
            "id": "B202600895134",
            "type": "modification",
            "publication_date": "2026-05-11",
            "event_date": null,
            "family_code": "modification",
            "family": "Modifications diverses",
            "notice_type": "Avis initial",
            "title": "Modifications diverses",
            "description": "modification survenue sur l'administration",
            "tribunal": "Greffe du Tribunal des Activités Economiques de Paris",
            "department": "75",
            "city": "Paris",
            "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:B202600895134"
        },
        {
            "id": "B202600705285",
            "type": "modification",
            "publication_date": "2026-04-12",
            "event_date": null,
            "family_code": "modification",
            "family": "Modifications diverses",
            "notice_type": "Avis initial",
            "title": "Modifications diverses",
            "description": "modification survenue sur l'administration",
            "tribunal": "Greffe du Tribunal des Activités Economiques de Paris",
            "department": "75",
            "city": "Paris",
            "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:B202600705285"
        }
    ]
}
Generated : 2026-09-03T15:33:26+00:00
$Billing policy

0.010 $ / call · charged on valid result · empty result not charged · errors not charged.

Input / Output schemas

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

OpenAPI 3.1 →
Input schema
identifierstringRequired · 9-digit SIREN or 14-digit SIRET
limitintegerOptional · Maximum number of normalized BODACC events to return
sincestringOptional · 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
identifierstringRequired
identifier_typestringRequired
existsbooleanRequired
sirenstring | nullRequired
namestring | nullRequired
total_countintegerRequired
returned_countintegerRequired
truncatedbooleanRequired
latest_eventobject | nullRequired
eventsarrayRequired
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"
                        ]
                    },
                    "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

Queries published with the API to help select the right endpoint.

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?