{
"openapi": "3.0.1",
"info": {
"title": "German Insolvency Monitor 🇩🇪 Insolvenzbekanntmachungen alerts",
"description": "Every new German insolvency announcement the day the court publishes it, from the official Insolvenzbekanntmachungen portal. Openings, dismissals for lack of assets, protective measures and discharges, with Handelsregister number, appointed administrator and a Slack digest of only-new notices.",
"version": "0.1",
"x-build-id": "lwrQX2IVNegi8Ta1v"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tagadanar~german-insolvency-monitor/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tagadanar-german-insolvency-monitor",
"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/tagadanar~german-insolvency-monitor/runs": {
"post": {
"operationId": "runs-sync-tagadanar-german-insolvency-monitor",
"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/tagadanar~german-insolvency-monitor/run-sync": {
"post": {
"operationId": "run-sync-tagadanar-german-insolvency-monitor",
"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": {
"noticeTypes": {
"title": "Notice types",
"type": "array",
"description": "Which insolvency announcements to track. Openings are the hard event most buyers want. Dismissals for lack of assets mean the company is gone without a distribution, and protective measures come days before an opening.",
"items": {
"type": "string",
"enum": [
"EROEFF",
"SICHMASS",
"ABWMASS",
"ENT_VERF",
"ENT_AUF_VERF",
"ENT_RSB",
"VERTVERZ",
"INSO_PLAN",
"SONST"
],
"enumTitles": [
"Insolvency proceedings opened (Eröffnungen)",
"Preliminary protective measures (Sicherungsmaßnahmen)",
"Petition dismissed for lack of assets (Abweisung mangels Masse)",
"Decisions during the proceeding (Entscheidungen im Verfahren)",
"Decisions after the proceeding closed (Entscheidungen nach Aufhebung)",
"Discharge of residual debt (Restschuldbefreiung)",
"Distribution schedules (Verteilungsverzeichnisse, § 188 InsO)",
"Supervised insolvency plans (Überwachte Insolvenzpläne)",
"Other notices (Sonstiges)"
]
},
"default": [
"EROEFF"
]
},
"states": {
"title": "Federal states (Bundesländer)",
"type": "array",
"description": "Limit the search to these federal states. Leave empty for all of Germany, which is also the cheapest option: the portal answers one nationwide query per day, while each state you list adds a query.",
"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"
]
},
"default": []
},
"keywords": {
"title": "Company / name watchlist (optional)",
"type": "array",
"description": "Only return notices matching these words: a company name, a town, a court, a case number or, with notice texts on, anything in the published text. Umlauts and their transcriptions match each other (München finds Muenchen). Leave empty to get every notice of the selected types.",
"default": [],
"items": {
"type": "string"
}
},
"sinceDays": {
"title": "Look back this many days",
"minimum": 1,
"maximum": 30,
"type": "integer",
"description": "Only notices published within the last N days. A scheduled daily monitor needs 2 or 3; a first sweep can look back further. The portal deletes notices on the § 3 InsoBekV schedule, so very old days return less.",
"default": 3
},
"includeNoticeText": {
"title": "Include the full notice text",
"type": "boolean",
"description": "Fetch the complete published text of every notice, which also fills in the appointed insolvency administrator, the court decision date and the § 174 InsO deadline for filing claims. This is one extra request per notice, so it makes a broad run noticeably slower.",
"default": false
},
"maxNotices": {
"title": "Max notices per run",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Stop after collecting this many notices. Caps cost and runtime on a broad sweep. For scale: the whole of Germany publishes roughly 5,000 notices of all types on a working day, of which about 500 are proceedings actually opened.",
"default": 500
},
"monitorMode": {
"title": "Monitor mode (alert on new notices only)",
"type": "boolean",
"description": "Remember notices already reported across runs and return only newly published ones. Built for a scheduled run: the first run sets the baseline, later runs report and charge for new notices only.",
"default": false
},
"webhookUrl": {
"title": "Webhook URL (Slack-compatible)",
"type": "string",
"description": "When monitor mode finds new notices, post a text digest here (Slack incoming webhook or any endpoint accepting {\"text\": \"...\"} JSON)."
}
}
},
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}