---
title: "Search for insolvency proceedings"
method: POST
path: "/v1/search/insolvency"
tags: ["v1"]
---

# Search for insolvency proceedings

`POST /v1/search/insolvency`

## Request body

- InsolvencySearchRequest
  - `query` InsolvencySearchRequestQuery
    - `value` string, required — Search query to filter insolvency proceedings. Matches against debtor name, case number, administrator name and court.
  - `filters` InsolvencySearchFilter[] — Filters to filter insolvency proceedings.
    - `value` string
    - `min` string
    - `max` string
    - `values` string[]
    - `keywords` string[]
    - `field` 'debtor_kind' | 'debtor_legal_form' | 'court' | 'city' | 'current_status' | 'has_open_insolvency' | 'proceeding_kind' | 'administration_kind' | 'insolvency_grounds' | 'opened_at' | 'closed_at' | 'last_event_at' | 'claims_filing_deadline' | 'company_id' | 'person_id', required — Field of the insolvency proceeding to filter on. Date fields (opened_at, closed_at, last_event_at, claims_filing_deadline) support min/max ranges with values in the format YYYY-MM-DD.
  - `pagination` SearchRequestPagination
    - `page` integer — Page number to return.
    - `per_page` integer — Number of results per page.

## Response `200`

Successful search operation

- InsolvencySearchResponse
  - `results` InsolvencySearchResponseItem[], required — List of insolvency proceedings matching the search criteria.
    - `id` string, required — Unique insolvency proceeding identifier.
    - `debtor_name` string, required — Name of the debtor. Example: "Max Mustermann GmbH"
    - `debtor_kind` 'legal_person' | 'natural_person', required — Kind of debtor the proceeding concerns. - legal_person: legal entities (companies, associations, etc.) - natural_person: private individuals
    - `debtor_legal_form` string, nullable, required — Legal form of the debtor, if the debtor is a company. Example: "gmbh"
    - `case_number` string, required — Case number of the proceeding at the insolvency court. Example: "36a IN 2792/24"
    - `court` string, required — Insolvency court handling the proceeding. Example: "Charlottenburg"
    - `city` string, nullable, required — City of the debtor. Example: "Berlin"
    - `current_status` 'preliminary' | 'opened' | 'rejected_no_assets' | 'mass_insufficient' | 'plan_supervised' | 'lifted' | 'discontinued' | 'discharge_pending' | 'discharge_granted' | 'discharge_denied' | 'discharge_revoked' | 'unknown', required — Current status of the insolvency proceeding.
    - `has_open_insolvency` boolean, required — Whether the proceeding is currently open.
    - `proceeding_kind` 'regular_insolvency' | 'consumer_insolvency', required — Kind of insolvency proceeding.
    - `administration_kind` 'external_administration' | 'self_administration' | 'protective_shield', required — Kind of administration ordered for the proceeding.
    - `insolvency_grounds` string[], nullable, required — Grounds for the insolvency, e.g. "illiquidity", "over_indebtedness".
    - `administrator_name` string, nullable, required — Name of the insolvency administrator.
    - `company_id` string, nullable, required — Unique company identifier of the debtor, if the debtor could be matched to a registered company. Example: DE-HRB-F1103-267645
    - `person_id` string, nullable, required — Unique person identifier of the debtor, if the debtor could be matched to a person.
    - `opened_at` string, date, nullable, required — Date the proceeding was opened. Format: ISO 8601 (YYYY-MM-DD)
    - `closed_at` string, date, nullable, required — Date the proceeding was closed. Format: ISO 8601 (YYYY-MM-DD)
    - `last_event_at` string, date, nullable, required — Date of the most recent event in the proceeding. Format: ISO 8601 (YYYY-MM-DD)
  - `pagination` Pagination, required
    - `page` integer, required — Current page number.
    - `per_page` integer, required — Number of results per page.
    - `total_pages` integer, required — Total number of pages.
    - `total_results` integer, required — Total number of results.

## Other responses

- `400` — Bad Request - Invalid parameters provided
- `401` — Unauthorized - Authentication required
- `402` — Payment Required - Insufficient credits for this request
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error - An error occurred while processing the request

---

[API](https://skmtc.net/oregister/apis/openregister-api.md) · [All operations](https://skmtc.net/oregister/apis/openregister-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oregister/openregister-api/revisions/d1fcaf6d6ca0/schema)