API-documentatie - Germany Insolvencies

Authenticatie

Elke aanvraag vereist uw persoonlijke API-sleutel in de header X-API-Key. Sleutels worden uitgegeven zodra uw API-toegang actief is.

X-API-Key: YOUR_API_KEY

Endpoint

Eén GET-endpoint levert de meldingen voor een bepaalde dag of periode.

GET https://germanyinsolvencies.com/api/v1/filings

Parameters

Alle parameters zijn optioneel. Zonder datum wordt de vorige dag geleverd. Maximale periode: 31 dagen per aanvraag.

Parameter	Description
date	Single day, format `YYYY-MM-DD`. Defaults to yesterday.
date_from / date_to	Date range (max. 31 days per request).
types	Comma-separated list of type aliases or codes. Omit for all types.
format	`json` (default) or `csv`.

Soorten meldingen

Filter via de parameter types. Scheid meerdere waarden met komma's; laat de parameter weg om alle soorten te ontvangen.

types=	Code	Bekanntmachungsart
sicherung	0	Sicherungsmaßnahmen / Protective measures
abweisung	1	Abweisungen mangels Masse / Dismissal for lack of assets
eroeffnung	2	Eröffnungen / Opening of proceedings
entscheidung	3	Entscheidungen im Verfahren / Decisions in proceedings
sonstiges	4	Sonstiges / Other
entscheidung_aufhebung	5	Entscheidungen nach Aufhebung / Decisions after termination
verteilungsverzeichnis	6	Verteilungsverzeichnisse (§ 188 InsO) / Distribution lists
restschuldbefreiung	7	Restschuldbefreiung / Discharge of residual debt
insolvenzplan	8	Überwachte Insolvenzpläne / Supervised insolvency plans

Voorbeeldaanvraag

Voorbeeld: alle openingen, bewarende maatregelen en afwijzingen van één dag als JSON.

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://germanyinsolvencies.com/api/v1/filings?date=2026-06-08&types=eroeffnung,sicherung,abweisung"

Antwoord

Het antwoord bevat het aantal resultaten en een array met meldingen. Gebruik format=csv om in plaats daarvan een CSV-bestand te ontvangen.

{
  "date_from": "2026-06-08",
  "date_to": "2026-06-08",
  "types": ["0", "1", "2"],
  "count": 142,
  "filings": [
    {
      "date": "2026-06-08",
      "type": "Eröffnungen",
      "type_code": "2",
      "name": "Beispiel GmbH",
      "sitz": "Berlin",
      "court": "Charlottenburg (Berlin)",
      "aktenzeichen": "36a IN 1234/26",
      "bundesland": "Berlin",
      "register": "HRB 12345",
      "text": "Im Insolvenzverfahren ..."
    }
  ]
}

Fouten

Fouten worden als JSON geretourneerd met een passende HTTP-statuscode.

HTTP	error
401	missing_api_key
403	invalid_api_key, subscription_expired
400	bad_date, bad_type, range_too_large
500	server_error

Toegang aanvragen

API-toegang wordt individueel ingericht. Neem contact met ons op met uw toepassing, dan zetten we uw sleutel klaar.

Neem contact op