Documentazione API

Accedi agli avvisi di insolvenza tedeschi giornalieri tramite la nostra API REST ed elaborali automaticamente nei tuoi sistemi.

Autenticazione

Ogni richiesta richiede la tua chiave API personale nell'intestazione X-API-Key. Le chiavi vengono rilasciate una volta attivato l'accesso API.

X-API-Key: YOUR_API_KEY

Endpoint

Un unico endpoint GET restituisce gli avvisi di un giorno o di un intervallo di date.

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

Parametri

Tutti i parametri sono facoltativi. Senza data viene restituito il giorno precedente. Intervallo massimo: 31 giorni per richiesta.

Parameter Description
dateSingle day, format YYYY-MM-DD. Defaults to yesterday.
date_from / date_toDate range (max. 31 days per request).
typesComma-separated list of type aliases or codes. Omit for all types.
formatjson (default) or csv.

Tipi di avviso

Filtra con il parametro types. Separa più valori con virgole; omettilo per ricevere tutti i tipi.

types= Code Bekanntmachungsart
sicherung0Sicherungsmaßnahmen / Protective measures
abweisung1Abweisungen mangels Masse / Dismissal for lack of assets
eroeffnung2Eröffnungen / Opening of proceedings
entscheidung3Entscheidungen im Verfahren / Decisions in proceedings
sonstiges4Sonstiges / Other
entscheidung_aufhebung5Entscheidungen nach Aufhebung / Decisions after termination
verteilungsverzeichnis6Verteilungsverzeichnisse (§ 188 InsO) / Distribution lists
restschuldbefreiung7Restschuldbefreiung / Discharge of residual debt
insolvenzplan8Überwachte Insolvenzpläne / Supervised insolvency plans

Richiesta di esempio

Esempio: tutte le aperture, misure cautelari e rigetti di un giorno in formato JSON.

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

Risposta

La risposta contiene il numero di risultati e un array di avvisi. Usa format=csv per ricevere invece un file CSV.

{
  "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 ..."
    }
  ]
}

Errori

Gli errori vengono restituiti come JSON con il codice di stato HTTP appropriato.

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

Ottenere l'accesso

L'accesso all'API viene fornito individualmente. Contattaci indicando il tuo caso d'uso e configureremo la tua chiave.

Contattaci