# German Insolvency API (Insolvenzbekanntmachungen) (`ayyouba/german-insolvency-api`) Actor

Check any German company against the official insolvency register (Insolvenzbekanntmachungen) for active proceedings — matched to the company name, with court and case numbers (Aktenzeichen). No login, no API key. For KYB, credit-risk and customer/supplier onboarding checks.

- **URL**: https://apify.com/ayyouba/german-insolvency-api.md
- **Developed by:** [Ayyoub Aharchi](https://apify.com/ayyouba) (community)
- **Categories:** Automation, Developer tools, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $40.00 / 1,000 company checkeds

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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## German Insolvency API — check companies against the Insolvenzbekanntmachungen register

**Is this German company insolvent? Get a clear answer in one call.**
This actor checks any German company against the **official insolvency register**
(Insolvenzbekanntmachungen) and returns whether there are **active insolvency
proceedings** matched to that company — with **court and case numbers
(Aktenzeichen)**. No login, no API key, no manual portal clicking.

Built for **credit-risk checks, KYB / business verification, supplier & customer
onboarding, and lead qualification** — anywhere you need to know a German company's
insolvency status before you sign, ship, or extend credit.

### What you get

For each company:

- **`isInsolvent`** — `true` / `false` (or `null` if the check couldn't complete)
- **`cases`** — matched proceedings with **file number (Aktenzeichen)**, **court**, and **date**
- **`checkedAt`** — timestamp of the check

The check **matches the debtor name to your company** — so a person or unrelated firm
that merely shares a surname does **not** produce a false "insolvent" flag.

### Input

```json
{
    "companies": ["Galeria Karstadt Kaufhof GmbH", "Musterfirma GmbH"]
}
```

Pass full legal names for best accuracy (e.g. `Musterfirma GmbH`, not just `Musterfirma`).

### Output (example)

```json
{
    "company": "Musterfirma GmbH",
    "isInsolvent": true,
    "caseCount": 1,
    "cases": [{ "fileNumber": "71 IN 123/26", "court": "München", "date": "18.07.2026" }],
    "source": "insolvenzbekanntmachungen.de",
    "checkedAt": "2026-07-20T10:00:00.000Z"
}
```

### Use in n8n

Run this check from your workflows with the community node
**[n8n-nodes-german-company-data](https://www.npmjs.com/package/n8n-nodes-german-company-data)**
(install via **Settings → Community Nodes** in n8n). Pick the *Insolvency Check* operation,
map company names from any previous node, and route on `isInsolvent`. Also usable as a tool
by n8n AI agents.

### Pricing

Pay-per-event: you're charged **only when a check completes with a definitive result**
(insolvent or not). Failed checks are free. See the listing for the current price.

### FAQ

**How current is it?** The official register retains active proceedings and those
concluded within the last ~6 months. This actor reflects that — it detects **active /
recent** insolvency, which is exactly the KYB risk signal you want.

**Does "not insolvent" guarantee solvency?** No — it means no matching proceeding was
found in the official register at check time. It is a strong risk signal, not a
certified financial audit.

**Which countries?** Germany. (Austria uses a separate register.)

### Related actors

- **[German Company Data & KYB Scraper](https://apify.com/ayyouba/dach-company-intel)** — full profile: register number, address, directors, VAT and financials, cross-referenced and verified.
- **[German Impressum Scraper](https://apify.com/ayyouba/german-impressum-scraper)** — cheap, HTTP-only company + contact data from any German website's Impressum.

> Not legal or financial advice. Provides public-register data only.

# Actor input Schema

## `companies` (type: `array`):

Company names to check against the German insolvency register. The full legal name works best (e.g. 'Musterfirma GmbH').

## `proxyConfiguration` (type: `object`):

The insolvency portal blocks datacenter IPs, so residential proxy is used by default.

## Actor input object example

```json
{
  "companies": [
    "Galeria Karstadt Kaufhof GmbH",
    "Kettler GmbH"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 = {
    "companies": [
        "Musterfirma GmbH"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("ayyouba/german-insolvency-api").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 = { "companies": ["Musterfirma GmbH"] }

# Run the Actor and wait for it to finish
run = client.actor("ayyouba/german-insolvency-api").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "companies": [
    "Musterfirma GmbH"
  ]
}' |
apify call ayyouba/german-insolvency-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=ayyouba/german-insolvency-api",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

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