{ "openapi": "3.0.1", "info": { "title": "German Insolvency Notices + Handelsregister Extractor", "description": "German company insolvencies from the official insolvenzbekanntmachungen.de as clean JSON: court, file number, procedure, insolvency administrator with contact, claims deadline. Optionally enriched with the structured Handelsregister record (XJustiz SI): share capital, purpose, managing directors.", "version": "1.0", "x-build-id": "wbjlK48RxYW4Fq0sq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/brsksr~german-insolvency-commercial-register/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-brsksr-german-insolvency-commercial-register", "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/brsksr~german-insolvency-commercial-register/runs": { "post": { "operationId": "runs-sync-brsksr-german-insolvency-commercial-register", "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/brsksr~german-insolvency-commercial-register/run-sync": { "post": { "operationId": "run-sync-brsksr-german-insolvency-commercial-register", "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": { "daysBack": { "title": "Days back", "minimum": 1, "maximum": 14, "type": "integer", "description": "Number of publication days to search, counting back from today (Europe/Berlin), today included. 1 = today only, 2 = today and yesterday. Ignored if 'Published from' is set.", "default": 2 }, "dateFrom": { "title": "Published from", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Optional start of the publication period, YYYY-MM-DD. The span is capped at 14 days." }, "dateTo": { "title": "Published until", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Optional end of the publication period, YYYY-MM-DD. Defaults to today." }, "subjects": { "title": "Notice types", "type": "array", "description": "Which kinds of insolvency decisions to load.", "items": { "type": "string", "enum": [ "EROEFF", "SICHMASS", "ABWMASS", "ENT_VERF", "ENT_AUF_VERF", "INSO_PLAN", "SONST" ], "enumTitles": [ "Eröffnungen (proceedings opened)", "Sicherungsmaßnahmen (preliminary administration)", "Abweisungen mangels Masse (dismissed for lack of assets)", "Entscheidungen im Verfahren (decisions during the proceedings)", "Entscheidungen nach Aufhebung (decisions after termination)", "Überwachte Insolvenzpläne (supervised insolvency plans)", "Sonstiges (other)" ] }, "default": [ "EROEFF", "SICHMASS", "ABWMASS" ] }, "onlyCorporate": { "title": "Companies only", "type": "boolean", "description": "Skip consumer and private insolvencies (IK file numbers) using the result list, free of charge. Keeps notices with a register entry (HRA, HRB, GnR, VR, PR) or a clear legal form in the name (GmbH, UG, AG, KG, OHG, e.K., SE, B.V., Ltd., eG, e.V. ...).", "default": true }, "federalStates": { "title": "Federal states", "type": "array", "description": "Optional. Only notices from insolvency courts in these states. Leave empty for all of Germany.", "items": { "type": "string", "enum": [ "BW", "BY", "BE", "BB", "HB", "HH", "HE", "MV", "NI", "NW", "RP", "SL", "SN", "ST", "SH", "TH" ], "enumTitles": [ "Baden-Württemberg", "Bayern", "Berlin", "Brandenburg", "Bremen", "Hamburg", "Hessen", "Mecklenburg-Vorpommern", "Niedersachsen", "Nordrhein-Westfalen", "Rheinland-Pfalz", "Saarland", "Sachsen", "Sachsen-Anhalt", "Schleswig-Holstein", "Thüringen" ] } }, "nameKeywords": { "title": "Keywords (company name or notice text)", "type": "array", "description": "Optional, case-insensitive. A notice is kept if a keyword appears in the company name or anywhere in the notice text, e.g. the line of business. Notices without a match are not output and not charged.", "items": { "type": "string" } }, "maxNotices": { "title": "Max. notices", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of extracted notices per run.", "default": 25 }, "enrichCommercialRegister": { "title": "Enrich with Handelsregister (SI)", "type": "boolean", "description": "Download the structured register content (XJustiz SI) from handelsregister.de for each company: legal form, share capital, business purpose, address, managing directors / partners and representation rules.", "default": true }, "maxEnrichments": { "title": "Max. register enrichments per run", "minimum": 0, "maximum": 25, "type": "integer", "description": "Caps the handelsregister.de lookups per run to protect the 60 per hour limit (25 lookups are about 51 requests). Notices beyond the cap are output without register data (status skipped_limit) and the register event is not charged. Schedule runs at most once per hour when using the maximum.", "default": 15 }, "includeOfficerPersonalData": { "title": "Include date of birth and place of residence of officers", "type": "boolean", "description": "Opt-in. Adds birthDate and cityOfResidence of natural persons from the register record and the raw 'represented by' clause of the notice (which can contain private addresses). Only enable this if you have a legal basis under the GDPR (Art. 6) for processing this data.", "default": false }, "includeFullText": { "title": "Include notice full text", "type": "boolean", "description": "Adds the complete text of the court decision to each record (fullText). The text can contain personal data of officers.", "default": false } } }, "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 } } } } } } } } } }