{ "openapi": "3.0.1", "info": { "title": "BODACC Monitor — French Insolvencies, Company Formations and", "description": "Watch the BODACC, the French official bulletin of civil and commercial legal announcements. Insolvency rulings with their procedure type and date, company formations, sales of businesses with the stated price, amendments, strike-offs and accounts filings — filtered by SIREN, department.", "version": "0.1", "x-build-id": "dZGLXdxlxJ1KrnHED" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dalbian~bodacc-french-company-notices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dalbian-bodacc-french-company-notices", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/dalbian~bodacc-french-company-notices/runs": { "post": { "operationId": "runs-sync-dalbian-bodacc-french-company-notices", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/dalbian~bodacc-french-company-notices/run-sync": { "post": { "operationId": "run-sync-dalbian-bodacc-french-company-notices", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "publishedWithinDays": { "title": "Published within (days)", "minimum": 0, "maximum": 7300, "type": "integer", "description": "Only notices published in the last N days. Set it to 1 and schedule the run each morning for a clean daily alert with nothing repeated. The BODACC publishes on working days only, so a one-day window over a weekend or a public holiday is empty by design. Leave it blank to search the whole register back to 2008.", "default": 7 }, "noticeFamilies": { "title": "Notice families", "type": "array", "description": "Which families of notice to keep. Leave empty for all of them. The counts are the whole register, not your window. Accounts filings alone are half the bulletin, so a run with no family filter is dominated by them.", "items": { "type": "string", "enum": [ "insolvency", "conciliation", "professionalRecovery", "salesAndTransfers", "companyFormations", "registrations", "amendments", "deregistrations", "accountsFilings", "miscellaneous" ], "enumTitles": [ "Insolvency proceedings — sauvegarde, redressement, liquidation (3.3M)", "Conciliation proceedings — out-of-court settlements (4.3k)", "Professional recovery — rétablissement professionnel (1.3k)", "Sales and transfers — fonds de commerce, mergers (892k)", "Company formations — créations (6.6M)", "Registrations — immatriculations, transfers in (728k)", "Amendments — officers, name, address, capital (8.5M)", "Deregistrations — radiations (4.2M)", "Accounts filings — dépôts des comptes (26.4M)", "Miscellaneous — court notices, judicial auctions (5k)" ] }, "default": [] }, "procedureTypes": { "title": "Insolvency ruling types", "type": "array", "description": "Narrow insolvency notices to specific court rulings. The register does not expose the ruling type as a field, so the Actor filters the bulletin text and then verifies the parsed ruling nature on every row — the summary reports how many rows the verification dropped. Use this with the insolvency family.", "items": { "type": "string", "enum": [ "openingLiquidation", "openingReceivership", "openingSafeguard", "conversionToLiquidation", "recoveryPlan", "assetSale", "planResolution", "closure", "directorSanction", "claimsFiled" ], "enumTitles": [ "Liquidation opened — jugement d'ouverture de liquidation judiciaire", "Receivership opened — ouverture d'un redressement judiciaire", "Safeguard opened — ouverture d'une procédure de sauvegarde", "Converted to liquidation — conversion en liquidation judiciaire", "Recovery plan approved or amended — plan de redressement / sauvegarde", "Business sold as a going concern — plan de cession", "Plan failed — résolution du plan", "Proceedings closed — clôture pour insuffisance d'actif or extinction du passif", "Director sanctioned — faillite personnelle, interdiction de gérer", "Creditor claims filed — dépôt de l'état des créances" ] }, "default": [] }, "noticeTypes": { "title": "Notice types", "type": "array", "description": "Leave empty for all. Choose initial notices only if you are building an alert and do not want a correction to a two-year-old notice landing in today's batch.", "items": { "type": "string", "enum": [ "initial", "correction", "cancellation" ], "enumTitles": [ "Initial notice — avis initial (50.6M)", "Correction — avis rectificatif (77k)", "Cancellation — avis d'annulation (66k)" ] }, "default": [] }, "departments": { "title": "Departments", "type": "array", "description": "French department numbers, one per line — 75, 69, 13, 2A, 971. Single digits are padded for you, so 1 and 01 both mean Ain.", "items": { "type": "string" } }, "sirens": { "title": "SIREN numbers", "type": "array", "description": "Watch specific companies, one nine-digit SIREN per line. Spaces are ignored and a fourteen-digit SIRET is cut back to its SIREN. A notice matches if the company appears in it in any role, including as the seller in a business sale.", "items": { "type": "string" } }, "companyNames": { "title": "Company names", "type": "array", "description": "Keep only notices whose trading name contains these words, one per line. Matching is literal and ignores case and accents; a trailing asterisk works as a wildcard.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Free-text words searched across the name, the stated activity, the court ruling and the deed, one per line, combined with OR. Use this to watch a sector — boulangerie, pharmacie, transport — rather than a named company.", "items": { "type": "string" } }, "tribunals": { "title": "Courts", "type": "array", "description": "Keep only notices from these registries, one per line — Bordeaux, Lyon, Nanterre. Matched against the court name as the bulletin writes it.", "items": { "type": "string" } }, "maxNotices": { "title": "Maximum notices", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Cap per run, newest first. The API will not page beyond 10 000 rows for one query; the summary row says so when that ceiling is reached.", "default": 200 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }