helpmyagent.com
EN Explorer les API

Événements d'entreprise française

Retourne les derniers événements publics BODACC d'une entreprise française à partir d'un SIREN ou d'un SIRET.

POST https://api.helpmyagent.com/v1/company/fr/events
$ 0.010 $ / appelfacturation sur résultat valide · résultat vide non facturé · erreur non facturée
FRCouvertureFR
DBSources documentées2
{ }Sortie structuréeJSON
⌁REST + MCPx402
$Pay-per-call0.010 $

Quand utiliser cette API ?

Les cas d’usage et limites sont publiés avec l’API pour faciliter une intégration correcte par un humain comme par un agent.

À utiliser quand

  • Vous avez besoin des événements BODACC récents et normalisés d’une entreprise française : dépôts, modifications, procédures collectives ou radiations.
  • Vous souhaitez une chronologie d’événements filtrée éventuellement à partir d’une date de publication.

À éviter quand

  • Vous recherchez un niveau de risque juridique interprété plutôt que des événements normalisés ; utilisez company/fr/risk.
  • Vous avez seulement besoin des champs administratifs actuels ; utilisez company/fr/profile.

Limitations

  • Le résultat reflète les annonces BODACC disponibles dans le jeu public ainsi que la limite et le filtre de date demandés.
  • Les événements normalisés sont des faits issus de la source et ne constituent ni un avis juridique ni un score de risque.

Sources et provenance

Les sources publiées pour cet endpoint sont affichées directement avec leur lien d’origine.

Réponse réelle stockée

Ce snapshot est servi depuis les données publiées en BDD sans exécuter l’API payante.

Voir le JSON complet →
company/fr/eventsStored demo
Requête
{
    "identifier": "356000000",
    "limit": 10
}
Réponse stockée
{
    "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"
        }
    ]
}
Générée : 2026-09-03T15:33:26+00:00
$Politique de facturation

0.010 $ / appel · facturation sur résultat valide · résultat vide non facturé · erreur non facturée.

Schémas Input / Output

Contrats simplifiés de l’endpoint. Le schéma complet reste disponible dans OpenAPI 3.1.

OpenAPI 3.1 →
Input schema
identifierstringObligatoire · SIREN à 9 chiffres ou SIRET à 14 chiffres
limitintegerOptionnel · Nombre maximal d’événements BODACC normalisés à retourner
sincestringOptionnel · Date de publication BODACC minimale incluse, au format YYYY-MM-DD
Voir le JSON Schema complet
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "pattern": "^[0-9]{9}([0-9]{5})?$",
            "description": "SIREN à 9 chiffres ou SIRET à 14 chiffres"
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 20,
            "description": "Nombre maximal d’événements BODACC normalisés à retourner"
        },
        "since": {
            "type": "string",
            "format": "date",
            "description": "Date de publication BODACC minimale incluse, au format YYYY-MM-DD"
        }
    },
    "required": [
        "identifier"
    ],
    "additionalProperties": false
}
Output schema
identifierstringObligatoire
identifier_typestringObligatoire
existsbooleanObligatoire
sirenstring | nullObligatoire
namestring | nullObligatoire
total_countintegerObligatoire
returned_countintegerObligatoire
truncatedbooleanObligatoire
latest_eventobject | nullObligatoire
eventsarrayObligatoire
Voir le JSON Schema complet
{
    "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
}

Exemples de requêtes

Formulations publiées avec l’API pour aider à sélectionner le bon endpoint.

Quels sont les derniers événements BODACC du SIREN 356000000 ?
Montre les annonces publiées depuis le 2026-01-01.
Cette entreprise a-t-elle eu récemment une modification ou une radiation ?