{ "openapi": "3.0.1", "info": { "title": "German Insolvency Announcements — Insolvenzbekanntmachungen", "description": "Insolvency filings from Germany's official register (insolvenzbekanntmachungen.de) — all 16 states, 193 courts. Full announcement text plus parsed fields: administrator with phone and email, claim deadline, distribution amount, file number. Only 14 days are searchable, so run it as a monitor.", "version": "0.1", "x-build-id": "LTME4cJL4PMoyLdbk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/us0r~insolvenzbekanntmachungen-de/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-us0r-insolvenzbekanntmachungen-de", "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/us0r~insolvenzbekanntmachungen-de/runs": { "post": { "operationId": "runs-sync-us0r-insolvenzbekanntmachungen-de", "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/us0r~insolvenzbekanntmachungen-de/run-sync": { "post": { "operationId": "run-sync-us0r-insolvenzbekanntmachungen-de", "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": { "bundeslaender": { "title": "Federal states (Bundesländer)", "type": "array", "description": "Which states to cover. Leave empty for all 16.", "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 (Bavaria)", "Berlin", "Brandenburg", "Bremen", "Hamburg", "Hessen (Hesse)", "Mecklenburg-Vorpommern", "Niedersachsen (Lower Saxony)", "Nordrhein-Westfalen (North Rhine-Westphalia)", "Rheinland-Pfalz", "Saarland", "Sachsen (Saxony)", "Sachsen-Anhalt", "Schleswig-Holstein", "Thüringen (Thuringia)" ] }, "default": [] }, "tageZurueck": { "title": "Days back from today", "minimum": 0, "maximum": 13, "type": "integer", "description": "0 = today only, 1 = today and yesterday. Three days is the default so that a run always covers a working day — German courts publish nothing on weekends. The portal only allows free searching of the last 14 days (§ 2 InsBekV). Ignored when explicit dates are given.", "default": 3 }, "datumVon": { "title": "From date (optional)", "type": "string", "description": "ISO date, e.g. 2026-08-10. Overrides 'days back'. Dates older than 14 days are clamped." }, "datumBis": { "title": "To date (optional)", "type": "string", "description": "ISO date, e.g. 2026-08-17. Defaults to today." }, "gegenstaende": { "title": "Announcement types", "type": "array", "description": "Restrict to certain kinds of announcement. Leave empty for all.", "items": { "type": "string", "enum": [ "EROEFF", "ABWMASS", "SICHMASS", "ENT_VERF", "ENT_RSB", "ENT_AUF_VERF", "VERTVERZ", "INSO_PLAN", "SONST" ], "enumTitles": [ "Openings (Eröffnungen)", "Dismissals for lack of assets (Abweisung mangels Masse)", "Protective measures (Sicherungsmaßnahmen)", "Decisions in proceedings (Entscheidungen im Verfahren)", "Debt discharge decisions (Restschuldbefreiung)", "Decisions after closure (nach Aufhebung)", "Distribution lists (§ 188 InsO)", "Supervised insolvency plans", "Other (Sonstiges)" ] }, "default": [] }, "volltext": { "title": "Fetch full announcement text", "type": "boolean", "description": "The full text carries the substance: distribution amounts, claim totals, deadlines, administrators, legal representatives. Costs one extra request per entry (~0.23 s).", "default": true }, "nurNeue": { "title": "Only new announcements", "type": "boolean", "description": "Remembers what previous runs already returned and skips it. Turn this on for monitoring so you are not charged for the same entry twice.", "default": false }, "suchbegriff": { "title": "Filter by name or place", "type": "string", "description": "Only keep entries whose debtor name or registered seat contains this text (case-insensitive)." }, "maxErgebnisse": { "title": "Maximum results", "minimum": 0, "type": "integer", "description": "Stop after this many entries. Set 0 for no limit — that is what you want for a real monitoring run; the default of 50 only keeps the very first trial run short.", "default": 50 }, "statusSpeicher": { "title": "State store name", "type": "string", "description": "Named key-value store holding the IDs already seen. Use different names to run several independent monitors.", "default": "insolvenz-gesehen" }, "pauseSekunden": { "title": "Delay between requests", "minimum": 0, "maximum": 10, "type": "number", "description": "Seconds to wait before each request to the portal.", "default": 0.2 } } }, "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 } } } } } } } } } }