API 문서 - Germany Insolvencies

인증

모든 요청에는 X-API-Key 헤더에 개인 API 키가 필요합니다. 키는 API 이용이 활성화되면 발급됩니다.

X-API-Key: YOUR_API_KEY

엔드포인트

단일 GET 엔드포인트가 특정 날짜 또는 기간의 공고를 반환합니다.

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

매개변수

모든 매개변수는 선택 사항입니다. 날짜를 지정하지 않으면 전날 데이터가 반환됩니다. 요청당 최대 기간은 31일입니다.

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`.

공고 유형

types 매개변수로 필터링합니다. 여러 값은 쉼표로 구분하며, 생략하면 모든 유형이 반환됩니다.

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

요청 예시

예: 특정 날짜의 모든 개시, 보전 조치, 기각을 JSON으로 가져옵니다.

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

응답

응답에는 결과 수와 공고 배열이 포함됩니다. format=csv를 사용하면 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 ..."
    }
  ]
}

오류

오류는 적절한 HTTP 상태 코드와 함께 JSON으로 반환됩니다.

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

이용 신청

API 이용은 개별적으로 제공됩니다. 사용 사례와 함께 문의해 주시면 키를 설정해 드립니다.

문의하기