Documentation de l'API

Accédez aux annonces d'insolvabilité allemandes quotidiennes via notre API REST et traitez-les automatiquement dans vos systèmes.

Authentification

Chaque requête nécessite votre clé API personnelle dans l'en-tête X-API-Key. Les clés sont délivrées une fois votre accès API actif.

X-API-Key: YOUR_API_KEY

Point de terminaison

Un seul point de terminaison GET renvoie les annonces d'un jour ou d'une période.

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

Paramètres

Tous les paramètres sont facultatifs. Sans date, la veille est renvoyée. Période maximale : 31 jours par requête.

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.

Types d'annonce

Filtrez avec le paramètre types. Séparez plusieurs valeurs par des virgules ; omettez-le pour recevoir tous les types.

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

Exemple de requête

Exemple : toutes les ouvertures, mesures conservatoires et rejets d'un jour au format JSON.

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

Réponse

La réponse contient le nombre de résultats et un tableau d'annonces. Utilisez format=csv pour recevoir un fichier 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 ..."
    }
  ]
}

Erreurs

Les erreurs sont renvoyées au format JSON avec le code de statut HTTP approprié.

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

Obtenir un accès

L'accès à l'API est fourni individuellement. Contactez-nous avec votre cas d'usage et nous configurerons votre clé.

Nous contacter