# BODACC Insolvency Alerts France: Watchlist & Sector (`geckostar/bodacc-insolvency-alerts-france`) Actor

New French insolvency notices from the official BODACC, only what you have not seen yet: watch your own list of SIRENs (customers, suppliers) or a sector by department and NAF code. Safeguard, receivership, liquidation, plans, closures; corrections and cancellations as updates.

- **URL**: https://apify.com/geckostar/bodacc-insolvency-alerts-france.md
- **Developed by:** [Gecko Lab](https://apify.com/geckostar) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 insolvency alerts

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## BODACC Insolvency Alerts France: watchlist and sector monitoring

Get the **new** insolvency notices published in the BODACC (the French official bulletin of commercial notices)
for the companies you care about, and only those you have not seen yet. Two ways to watch:

- **Watchlist**: paste the SIRENs of your customers, suppliers or debtors (up to 20,000). Each run tells you which of
  them got a new safeguard, receivership, liquidation, plan or closure notice.
- **Sector**: pick departments and, optionally, NAF activity codes. Each run lists the companies of that area and
  sector with a new insolvency notice.

Schedule it daily or weekly: you get each notice once, at the first run after it is published in the BODACC and
available in the official open dataset (usually a few days to a few weeks after the judgment). Corrections and cancellations of a notice you already received come back
as free updates, not as new alerts. No language model.

**Price: watchlist $0.0002 per SIREN checked per run + $0.01 per alert; sector $0.003 per notice ($0.005 with NAF
filter). The first run of a watch and failed runs are free.**

### How "only new" works

Give each watch a name (`watchId`). The Actor keeps, in a key-value store named `bodacc-alerts-<watchId>` **in
your own Apify account**, the IDs of the notices already seen over the last 30 days and the last publication date
read. The watch state is stored in your Apify account and holds notice IDs only: no SIREN, no company name, no
copy of your list. Nothing stays with the publisher of this Actor.

- **First run**: records the current state and returns nothing, free of charge. Set `includeLastDays` (1 to 30)
  to also receive the notices of the last N days on that first run.
- **Every run** re-reads at least the last 7 days of publications (the open dataset sometimes adds notices a few
  days late) and everything since the previous run, then drops the notices already seen.
- **Corrections and cancellations**: a correction (`rectificatif`) or a cancellation (`annulation`) of a notice you
  already received is returned as a row with `type_ligne` = `mise_a_jour`, free of charge. A notice cancelled
  before you received it is never returned.
- If more than 30 days pass between two runs, the run summary flags the gap (`periode_non_couverte`).
- Notices you did not receive because of your spending limit or `maxItems` are kept for the next run.
- Adding SIRENs to a watchlist: their notices of the re-read period come back as new alerts on the next run.
  Changing departments, NAF codes or notice types: use a new `watchId`.

### Sources (public, no key needed)

| Source | Used for |
|---|---|
| BODACC, `annonces-commerciales` dataset (DILA, `bodacc-datadila.opendatasoft.com`), "collective proceedings" family | every notice: type, judgment date, court, official link |
| Recherche d'entreprises API (`recherche-entreprises.api.gouv.fr`) | sector mode with NAF codes only: NAF code, headcount band, company category |

Source: DILA, BODACC, commercial notices; Recherche d'entreprises API (DINUM, INSEE and RNE data). Licence
Ouverte / Open Licence 2.0 (Etalab). Each row gives its source and the date the data was accessed (`source`,
`consulte_le`). Any re-use must keep this source notice and date.

The BODACC carries no NAF code: in sector mode with NAF codes, each new notice is looked up in the Recherche
d'entreprises API. The open dataset is shared by all its users and capped per day: when it answers "too many
requests", the run stops, nothing is charged and nothing is marked as seen.

### Personal data

The BODACC publishes court decisions about companies and about sole traders, who are natural persons. This Actor
is built to keep personal data to the minimum needed to monitor business partners:

- **Sector mode**: notices about a natural person (sole trader) are excluded, both in the query and when reading.
- **Watchlist mode**: a notice about a sole trader is returned only for a SIREN that you supplied, and without name
  or address: SIREN, type of proceedings, dates (judgment, cessation of payments), court and official link only.
  A company name (`denomination`) may still contain a person's name, for example its director's.
- **Never returned**: personal bankruptcy (`faillite personnelle`) and bans from managing a company (`interdiction de
  gérer`); the free text of judgments; the names of court-appointed administrators and liquidators; the names of
  former operators. The date of cessation of payments is read from the judgment text; nothing else is copied.
- **Watch state**: stored in your Apify account, it holds notice IDs and publication dates only. The run log
  contains no SIREN and no name.
- **Withdrawn notices**: a notice withdrawn by the DILA is no longer returned; you are responsible for deleting it
  from your past datasets.
- **Re-use rules**: re-using public information that contains personal data is subject to article L322-2 of the
  French code on relations between the public and the administration (CRPA) and to data protection law. In
  particular, use notices about sole traders only for the SIRENs of your own business partners, do not use these
  results to identify sole traders you do not already deal with, and do not combine them with other data to profile
  individuals.
- Controller for the tool: the publisher named in the legal notice. Legal basis: legitimate interest (GDPR art.
  6(1)(f)) in letting businesses monitor the financial situation of their partners from legal publications.
- Your rights: any data subject may object to appearing in the results, or exercise their rights of access and
  erasure, by writing to the contact address with the SIREN concerned. The SIREN is excluded from later runs within
  one month. Complaints may be lodged with the CNIL (cnil.fr).

**Your obligations as a user.** For your own purposes you become the controller of the data you retrieve. Use it
for credit, supplier or customer risk management and similar business purposes; keep it no longer than needed;
do not use it to canvass people in financial difficulty.

### Input

| Field | Default | Purpose |
|---|---|---|
| `mode` | `watchlist` | `watchlist` (your SIRENs) or `sector` (departments, NAF codes) |
| `watchId` | required | Name of the watch: lowercase letters, digits, hyphens, 40 characters at most |
| `sirens` | — | Watchlist mode: SIRENs or SIRETs, one per line, 20,000 at most |
| `departements` | all of France | Codes `01`…`95`, `2A`, `2B`, `971`…`976`; optional in watchlist mode |
| `nafCodes` | all | Sector mode: codes or prefixes `43`, `5610A`, `56.10A` |
| `procedureTypes` | all except claims lists | Notice types to return (see Output) |
| `includeLastDays` | 0 | First run only: also return the notices of the last N days (1 to 30) |
| `maxItems` | 1,000 | New notices per run at most (5,000); the rest waits for the next run |

Department and SIREN values are validated before entering the BODACC query: no other entered value goes into it.

### Output

One row per company and per notice. Output field names are in French.

- `type_ligne`: `nouvel_avis` (new notice, charged) or `mise_a_jour` (correction or cancellation of a notice already
  returned, free), with `mise_a_jour` (`rectificatif` or `annulation`) and `avis_vise_id` (the notice it updates).
- `siren`, `personne_physique` (true for a sole trader: no other identity field), and for a company `denomination`,
  `forme_juridique`, `activite_bodacc`, `departement`.
- `categorie`: `SAUVEGARDE`, `REDRESSEMENT_JUDICIAIRE`, `LIQUIDATION_JUDICIAIRE`, `PLAN_SAUVEGARDE`,
  `PLAN_REDRESSEMENT`, `PLAN_CESSION`, `CLOTURE_INSUFFISANCE_ACTIF`, `FIN_PROCEDURE`, `AUTRE_JUGEMENT`,
  `DEPOT_CREANCES` (claims list, off by default). Alsace-Moselle judgments, published as "other judgment", are
  classified from the start of their text.
- `procedure` (official label), `date_jugement`, `date_cessation_paiements` (when the judgment states it),
  `tribunal`, `date_parution`, `type_avis`, `annonce_id`, `url` (official notice on bodacc.fr).
- Sector mode with NAF codes: `code_naf`, `section_naf`, `tranche_effectif`, `categorie_entreprise`,
  `etat_administratif`.
- `surveillance` (your `watchId`), `source`, `consulte_le`, `facturable`.

The `BILAN` record of each run gives, in sector mode, the period re-read, the notices read, skipped (already seen,
natural persons, personal sanctions, other types, outside NAF), delivered and postponed, and the events charged. In
watchlist mode it only gives the number of SIRENs checked, the alerts and updates delivered or postponed, the events
charged and why a run stopped (spending limit, notice cap, timeout, BODACC outage, another run in progress): no
count of notices read or skipped, so that nothing can be inferred about a notice that is never returned.

### Pricing

| Event | Price | Charged when |
|---|---|---|
| `siren-checked` | $0.0002 | per SIREN of your watchlist, once per run, after the BODACC was read in full |
| `insolvency-alert` | $0.01 | per new notice row in watchlist mode |
| `notice-found` | $0.003 | per new notice row in sector mode |
| `notice-found-naf` | $0.005 | per new notice row in sector mode with NAF codes (lookup included) |

Example: 500 suppliers checked every weekday = $0.10 per run, about $2.20 per month, plus $0.01 per alert.
Nothing is charged for the first run of a watch (unless `includeLastDays` is set), for updates of notices already
returned, for skipped notices, or when the BODACC does not answer (quota or outage). If your spending limit does not
cover the SIRENs of the watchlist, the run stops before reading anything. The run stops cleanly at `maxItems` or at
your spending limit; the remaining notices wait for the next run.

### Related Actors

- [French Supplier Check](https://apify.com/geckostar/controle-fournisseur-france): one-off check of a supplier by
  SIREN or SIRET: status, EU VAT, BODACC notices and an OK / watch / risk verdict.
- [New Companies in France](https://apify.com/geckostar/nouvelles-societes-france): companies registered over a
  period, with NAF code.

***

## Version française — Alertes BODACC : portefeuille et secteur

Les **nouveaux** avis de procédure collective publiés au BODACC pour les entreprises qui vous intéressent, et
seulement ceux que vous n'avez pas encore vus. Deux façons de surveiller :

- **Portefeuille** : collez les SIREN de vos clients, fournisseurs ou débiteurs (20 000 au plus). Chaque exécution
  indique lesquels ont un nouvel avis de sauvegarde, redressement, liquidation, plan ou clôture.
- **Secteur** : choisissez des départements et, si vous voulez, des codes NAF. Chaque exécution liste les
  entreprises de cette zone et de ce secteur qui ont un nouvel avis de procédure collective.

Planifiez-le chaque jour ou chaque semaine : chaque avis vous parvient une fois, à la première exécution qui suit sa
publication au BODACC et sa mise à disposition dans le jeu ouvert (en général quelques jours à quelques semaines
après le jugement). Les rectificatifs et annulations d'un avis déjà reçu reviennent
comme mises à jour gratuites, pas comme nouvelles alertes. Aucun modèle de langage.

**Prix : portefeuille 0,0002 $ par SIREN vérifié et par exécution + 0,01 $ par alerte ; secteur 0,003 $ par avis
(0,005 $ avec filtre NAF). Le premier passage d'une surveillance et les exécutions en échec sont gratuits.**

### Seulement le nouveau

Donnez un nom à chaque surveillance (`watchId`). L'outil garde, dans un magasin clé-valeur nommé
`bodacc-alerts-<watchId>` **de votre propre compte Apify**, les identifiants des avis déjà vus sur les 30 derniers
jours et la dernière date de parution lue. Cet état ne contient que des identifiants d'avis : ni SIREN, ni
dénomination, ni copie de votre liste. Rien n'est conservé chez l'éditeur de l'outil.

- **Premier passage** : enregistre l'état actuel sans rien livrer ni facturer. Avec `includeLastDays` (1 à 30), ce
  premier passage livre aussi les avis des N derniers jours.
- **À chaque exécution**, l'outil relit au moins les 7 derniers jours de parution (le jeu ouvert ajoute parfois des
  avis avec quelques jours de retard) et tout ce qui a paru depuis l'exécution précédente, puis écarte les avis déjà
  vus.
- **Rectificatifs et annulations** d'un avis déjà reçu : une ligne `type_ligne` = `mise_a_jour`, gratuite. Un avis
  annulé avant de vous avoir été livré n'est jamais livré.
- Plus de 30 jours entre deux exécutions : le bilan signale le trou (`periode_non_couverte`).
- Les avis non livrés à cause de la limite de dépense ou de `maxItems` sont gardés pour l'exécution suivante.
- Ajout de SIREN au portefeuille : leurs avis de la période relue arrivent comme nouvelles alertes. Changement de
  départements, de codes NAF ou de types d'avis : prenez un nouveau `watchId`.

### Sources (publiques, sans clé)

| Source | Usage |
|---|---|
| BODACC, jeu `annonces-commerciales` (DILA, `bodacc-datadila.opendatasoft.com`), famille « procédures collectives » | chaque avis : nature, date du jugement, tribunal, lien officiel |
| API Recherche d'entreprises (`recherche-entreprises.api.gouv.fr`) | mode secteur avec codes NAF seulement : code NAF, tranche d'effectif, catégorie d'entreprise |

Sources : DILA, BODACC, annonces commerciales ; API Recherche d'entreprises (DINUM, données INSEE et RNE). Licence
Ouverte 2.0 (Etalab). Chaque ligne indique sa source et la date de consultation (`source`, `consulte_le`). Toute
réutilisation doit conserver cette mention de source et cette date.

Le BODACC ne donne pas de code NAF : en mode secteur avec codes NAF, chaque nouvel avis est complété par l'API
Recherche d'entreprises. Le jeu ouvert est partagé entre tous ses utilisateurs et plafonné par jour : quand il
répond « trop de requêtes », l'exécution s'arrête, rien n'est facturé et rien n'est marqué comme vu.

### Données personnelles

Le BODACC publie des décisions de justice qui visent des sociétés et des entrepreneurs individuels, personnes
physiques. L'outil réduit les données personnelles au strict nécessaire pour surveiller des partenaires
commerciaux :

- **Mode secteur** : les avis qui visent une personne physique (entrepreneur individuel) sont exclus, dans la
  requête et à la lecture.
- **Mode portefeuille** : un avis visant un entrepreneur individuel n'est livré que pour un SIREN que vous avez
  fourni, et sans nom ni adresse : SIREN, type de procédure, dates (jugement, cessation des paiements), tribunal et
  lien officiel seulement. Une dénomination de société peut toutefois reprendre le nom d'une personne, par exemple
  son dirigeant.
- **Jamais livrés** : la faillite personnelle et l'interdiction de gérer ; le texte libre des jugements ; les noms
  des administrateurs, mandataires et liquidateurs ; les noms des précédents exploitants. La date de cessation des
  paiements est lue dans le texte du jugement ; rien d'autre n'en est recopié.
- **État de la surveillance** : rangé dans votre compte Apify, il ne contient que des identifiants d'avis et leurs
  dates de parution. Le journal d'exécution ne contient ni SIREN ni nom.
- **Avis retirés** : un avis retiré par la DILA n'est plus livré ; il vous appartient de le supprimer de vos jeux de
  données passés.
- **Règles de réutilisation** : la réutilisation d'informations publiques comportant des données personnelles est
  soumise à l'article L322-2 du code des relations entre le public et l'administration (CRPA) et au droit de la
  protection des données. En particulier, n'utilisez les avis visant un entrepreneur individuel que pour les
  SIREN de vos propres partenaires commerciaux, n'utilisez pas ces résultats pour identifier des entrepreneurs
  individuels avec qui vous n'êtes pas en relation, et ne les croisez pas avec d'autres données pour profiler des
  personnes.
- Responsable de l'outil : l'éditeur indiqué dans les mentions légales. Base légale : intérêt légitime (RGPD,
  art. 6.1.f) à permettre aux entreprises de suivre la situation financière de leurs partenaires à partir de
  publications légales.
- Vos droits : toute personne concernée peut s'opposer à figurer dans les résultats ou exercer ses droits d'accès et
  d'effacement en écrivant à l'adresse de contact, avec le numéro SIREN concerné. Le SIREN est exclu des exécutions
  suivantes dans un délai d'un mois. Réclamation possible auprès de la CNIL (cnil.fr).

**Vos obligations en tant qu'utilisateur.** Pour vos propres finalités, vous devenez responsable du traitement des
données que vous récupérez. Employez-les pour la gestion du risque client, fournisseur ou de crédit et des finalités
professionnelles comparables ; ne les gardez pas plus longtemps que nécessaire ; ne les utilisez pas pour démarcher
des personnes en difficulté financière.

### Entrée

| Champ | Défaut | Rôle |
|---|---|---|
| `mode` | `watchlist` | `watchlist` (vos SIREN) ou `sector` (départements, codes NAF) |
| `watchId` | obligatoire | Nom de la surveillance : minuscules, chiffres, tirets, 40 caractères au plus |
| `sirens` | — | Mode portefeuille : SIREN ou SIRET, un par ligne, 20 000 au plus |
| `departements` | toute la France | Codes `01`…`95`, `2A`, `2B`, `971`…`976` ; facultatif en mode portefeuille |
| `nafCodes` | toutes | Mode secteur : codes ou débuts de code `43`, `5610A`, `56.10A` |
| `procedureTypes` | tous sauf dépôts de créances | Types d'avis à livrer (voir Sortie) |
| `includeLastDays` | 0 | Premier passage seulement : livrer aussi les avis des N derniers jours (1 à 30) |
| `maxItems` | 1 000 | Nouveaux avis par exécution au plus (5 000) ; le reste attend l'exécution suivante |

Les départements et les SIREN sont validés avant d'entrer dans la requête BODACC : aucune autre valeur saisie n'y
entre.

### Sortie

Une ligne par entreprise et par avis.

- `type_ligne` : `nouvel_avis` (facturé) ou `mise_a_jour` (rectificatif ou annulation d'un avis déjà livré,
  gratuit), avec `mise_a_jour` (`rectificatif` ou `annulation`) et `avis_vise_id` (l'avis mis à jour).
- `siren`, `personne_physique` (vrai pour un entrepreneur individuel : aucun autre champ d'identité), et pour une
  société `denomination`, `forme_juridique`, `activite_bodacc`, `departement`.
- `categorie` : `SAUVEGARDE`, `REDRESSEMENT_JUDICIAIRE`, `LIQUIDATION_JUDICIAIRE`, `PLAN_SAUVEGARDE`,
  `PLAN_REDRESSEMENT`, `PLAN_CESSION`, `CLOTURE_INSUFFISANCE_ACTIF`, `FIN_PROCEDURE`, `AUTRE_JUGEMENT`,
  `DEPOT_CREANCES` (dépôt de l'état des créances, désactivé par défaut). Les jugements d'Alsace-Moselle, publiés en
  « autre jugement », sont classés d'après le début de leur texte.
- `procedure` (libellé officiel), `date_jugement`, `date_cessation_paiements` (quand le jugement la donne),
  `tribunal`, `date_parution`, `type_avis`, `annonce_id`, `url` (avis officiel sur bodacc.fr).
- Mode secteur avec codes NAF : `code_naf`, `section_naf`, `tranche_effectif`, `categorie_entreprise`,
  `etat_administratif`.
- `surveillance` (votre `watchId`), `source`, `consulte_le`, `facturable`.

L'enregistrement `BILAN` de chaque exécution donne, en mode secteur, la période relue, les avis lus, écartés (déjà
vus, personnes physiques, sanctions personnelles, autres types, hors NAF), livrés et reportés, et les événements
facturés. En mode portefeuille, il ne donne que le nombre de SIREN vérifiés, les alertes et mises à jour livrées ou
reportées, les événements facturés et le motif d'un arrêt (limite de dépense, plafond d'avis, délai, panne du BODACC,
autre exécution en cours) : aucun compteur d'avis lus ou écartés, pour que rien ne se déduise d'un avis jamais livré.

### Facturation

| Événement | Prix | Facturé |
|---|---|---|
| `siren-checked` | 0,0002 $ | par SIREN du portefeuille, une fois par exécution, après lecture complète du BODACC |
| `insolvency-alert` | 0,01 $ | par ligne de nouvel avis en mode portefeuille |
| `notice-found` | 0,003 $ | par ligne de nouvel avis en mode secteur |
| `notice-found-naf` | 0,005 $ | par ligne de nouvel avis en mode secteur avec codes NAF (enrichissement compris) |

Exemple : 500 fournisseurs vérifiés chaque jour ouvré = 0,10 $ par exécution, environ 2,20 $ par mois, plus 0,01 $
par alerte. Rien n'est facturé pour le premier passage d'une surveillance (sauf avec `includeLastDays`), pour les
mises à jour d'avis déjà livrés, pour les avis écartés, ni quand le BODACC ne répond pas (quota ou panne). Si votre
limite de dépense ne couvre pas les SIREN du portefeuille, l'exécution s'arrête avant toute lecture. L'exécution
s'arrête proprement à `maxItems` ou à la limite de dépense ; les avis restants attendent l'exécution suivante.

***

### Conditions d'utilisation / Terms

Outil destiné aux professionnels, pour suivre la situation de partenaires commerciaux. Il reprend les avis publiés au BODACC tels que la DILA les met à disposition dans son jeu de données ouvert, au moment de l'exécution, sans garantie d'exhaustivité ni d'actualité : un avis peut paraître dans le jeu ouvert avec retard, le classement d'un jugement et la date de cessation des paiements sont lus automatiquement et peuvent être erronés, et seul l'avis officiel fait foi. L'outil ne constitue ni une évaluation de solvabilité ni un conseil. L'éditeur ne répond pas des décisions prises sur la seule base de ces résultats, ni de l'usage que l'utilisateur en fait, dans les limites permises par la loi. Cette clause n'écarte aucun droit que la loi réserve aux consommateurs, notamment la garantie légale de conformité des contenus et services numériques.

Intended for business use, to monitor business partners. Based on BODACC notices as published by the DILA in its open dataset, read at run time, with no guarantee of completeness or freshness: a notice may reach the open dataset late, judgment categories and cessation-of-payments dates are read automatically and may be wrong, and only the official notice is authoritative. Not a credit rating nor advice. To the extent permitted by law, the developer is not liable for decisions based solely on these results or for the user's use of them. Nothing here limits statutory consumer rights.

### Mentions légales / Legal notice

- Éditeur et vendeur / Publisher and seller : Audric Moussaoui, entrepreneur individuel (EI), pseudonyme « geckostar » / pseudonym "geckostar"
- Adresse / Address : 88 rue Oberkampf, 75011 Paris, France
- Téléphone / Phone : +33 6 95 11 28 15
- Courriel / E-mail : audricmm@gmail.com
- SIREN : en cours d'attribution, déclaration d'activité déposée le 24/10/2026 / being assigned, registration filed on 24 October 2026
- Directeur de la publication / Publication director : Audric Moussaoui
- TVA non applicable, art. 293 B du CGI / VAT not applicable (French VAT franchise, art. 293 B CGI)
- Hébergement / Hosting : Apify Technologies s.r.o., Vodičkova 704/36, 110 00 Prague 1, République tchèque / Czech Republic (hello@apify.com)

# Actor input Schema

## `mode` (type: `string`):

Watchlist: your own list of SIRENs (customers, suppliers, debtors). Sector: every company with a new notice in some departments, optionally filtered by NAF code.

## `watchId` (type: `string`):

Name of this watch (lowercase letters, digits and hyphens, 40 characters at most). Runs with the same name only return notices not seen yet; the watch state is stored in your Apify account, in a key-value store named bodacc-alerts-<name>. Use one name per list or sector.

## `sirens` (type: `array`):

One SIREN (9 digits) or SIRET (14 digits) per line, spaces allowed. 20,000 at most. Invalid lines are skipped and counted in the run summary.

## `departements` (type: `array`):

Department codes of the company (31, 75, 2A, 971…). Sector mode: the area to watch; empty means all of France. Watchlist mode: optional, narrows the reading.

## `nafCodes` (type: `array`):

NAF activity codes or code prefixes: “43” (specialised construction), “56.10A”… The BODACC has no NAF code: each new notice is looked up in the public Recherche d'entreprises API. Empty: all activities.

## `procedureTypes` (type: `array`):

Personal sanctions (personal bankruptcy, ban from managing) are never returned. Claims lists are left out by default.

## `includeLastDays` (type: `integer`):

Only used on the first run of a watch. 0 (default): the first run records the current state without returning or charging anything, and later runs return only new notices. 1 to 30: the first run also returns the notices published in the last N days.

## `maxItems` (type: `integer`):

Notices beyond this number are kept for the next run, not lost.

## Actor input object example

```json
{
  "mode": "watchlist",
  "watchId": "my-suppliers",
  "sirens": [
    "552 032 534"
  ],
  "procedureTypes": [
    "SAUVEGARDE",
    "REDRESSEMENT_JUDICIAIRE",
    "LIQUIDATION_JUDICIAIRE",
    "PLAN_SAUVEGARDE",
    "PLAN_REDRESSEMENT",
    "PLAN_CESSION",
    "CLOTURE_INSUFFISANCE_ACTIF",
    "FIN_PROCEDURE",
    "AUTRE_JUGEMENT"
  ],
  "includeLastDays": 0,
  "maxItems": 1000
}
```

# Actor output Schema

## `results` (type: `string`):

Une ligne par entreprise et par avis nouveau (facturée), ou par mise à jour d'un avis déjà signalé (gratuite).

## `bilan` (type: `string`):

Secteur : période relue, avis lus, écartés, livrés, reportés et événements facturés. Portefeuille : SIREN vérifiés, alertes et mises à jour livrées, reportées, événements facturés et motifs d'arrêt, sans compteur d'avis lus ou écartés.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "watchId": "my-suppliers",
    "sirens": [
        "552 032 534"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("geckostar/bodacc-insolvency-alerts-france").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "watchId": "my-suppliers",
    "sirens": ["552 032 534"],
}

# Run the Actor and wait for it to finish
run = client.actor("geckostar/bodacc-insolvency-alerts-france").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "watchId": "my-suppliers",
  "sirens": [
    "552 032 534"
  ]
}' |
apify call geckostar/bodacc-insolvency-alerts-france --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,geckostar/bodacc-insolvency-alerts-france"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ZEswyPDHgyESkT6og/builds/pl75mykmEtinKtHEW/openapi.json