> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openregister.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Insolvency proceeding

## Retrieve an insolvency proceeding

Get the full record of a single insolvency proceeding, including its complete event history. Each proceeding is assembled from the official insolvency announcements and tracks the case from the first security measures through opening, distributions, and discharge.

**Cost:** 10 credits

### Proceeding Data Structure

The response covers the whole lifecycle of a case:

* **Status:** `current_status` reflects where the proceeding stands (e.g. `preliminary`, `opened`, `rejected_no_assets`, `lifted`, `discharge_granted`)
* **Debtor:** name, kind (legal or natural person), legal form, and — where resolvable — the linked `company_id` for direct lookup of the debtor company
* **Administration:** administrator name and address, administration kind (external administration, self administration, protective shield)
* **Deadlines and distributions:** `claims_filing_deadline`, opening and closing dates, and distribution figures (`distribution_claims_total`, `distribution_available`)
* **Events:** every published announcement as a structured event with a summary, decision and publication dates, and typed `details` (administrator appointments, meetings, discharge decisions, distribution records)

### Use Cases

**Case Tracking:** Follow a specific proceeding over time — new events appear as the courts publish announcements, from preliminary measures to the final discharge decision.

**Due Diligence:** Reconstruct the full insolvency history of a counterparty, including past proceedings, administrators involved, and how the case was resolved.

**Legal Research:** Access structured summaries of each announcement together with meeting dates and locations, without parsing the original court publications yourself.


## OpenAPI

````yaml GET /v1/insolvency/{insolvency_id}
openapi: 3.1.0
info:
  title: OpenRegister API
  version: 2.5.0
  description: >
    API for accessing comprehensive company data from official registers.

    This API provides access to company information, shareholder data, financial
    reports, and contact details.
servers:
  - url: https://api.openregister.de
    description: Production
security:
  - BearerAuth: []
paths:
  /v1/insolvency/{insolvency_id}:
    get:
      tags:
        - v1
      summary: Get detailed insolvency proceeding information
      operationId: getInsolvency
      parameters:
        - name: insolvency_id
          in: path
          required: true
          description: The id of the insolvency proceeding
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Successfully retrieved insolvency proceeding data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Insolvency'
        '400':
          description: Bad Request - Invalid parameters provided
        '401':
          description: Unauthorized - Authentication required
        '402':
          description: Payment Required - Insufficient credits for this request
        '404':
          description: Not Found - Insolvency ID doesn't exist
        '429':
          description: Too Many Requests - Rate limit exceeded
        '500':
          description: >-
            Internal Server Error - An error occurred while processing the
            request
      x-codeSamples:
        - lang: JavaScript
          source: >-
            import Openregister from 'openregister';


            const client = new Openregister({
              apiKey: process.env['OPENREGISTER_API_KEY'], // This is the default and can be omitted
            });


            const response = await
            client.insolvency.getDetailsV1('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e');


            console.log(response.id);
        - lang: Python
          source: |-
            import os
            from openregister import Openregister

            client = Openregister(
                api_key=os.environ.get("OPENREGISTER_API_KEY"),  # This is the default and can be omitted
            )
            response = client.insolvency.get_details_v1(
                "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
            )
            print(response.id)
        - lang: Go
          source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/oregister/openregister-go\"\n\t\"github.com/oregister/openregister-go/option\"\n)\n\nfunc main() {\n\tclient := openregister.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tresponse, err := client.Insolvency.GetDetailsV1(context.TODO(), \"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", response.ID)\n}\n"
        - lang: CLI
          source: |-
            openregister insolvency get-details-v1 \
              --api-key 'My API Key' \
              --insolvency-id 182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e
components:
  schemas:
    Insolvency:
      type: object
      description: |
        An insolvency proceeding with all of its published events.
      properties:
        id:
          description: |
            Unique identifier of the insolvency proceeding.
          type: string
          format: uuid
        court:
          description: |
            Insolvency court handling the proceeding.
          type: string
        case_number:
          description: |
            Case number of the proceeding at the court.
            Example: "36d IN 3382/25"
          type: string
        company_id:
          description: |
            Unique company identifier of the debtor, if the debtor is a
            registered company. Example: DE-HRB-F1103-267645
          type: string
          nullable: true
        debtor_name:
          description: |
            Name of the debtor as published by the court.
          type: string
        debtor_kind:
          description: |
            Kind of debtor the proceeding concerns. Null when unknown.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/InsolvencyDebtorKind'
        debtor_legal_form:
          description: |
            Legal form of the debtor as published by the court.
          type: string
          nullable: true
        proceeding_kind:
          description: |
            Kind of insolvency proceeding. Null when unknown.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/InsolvencyProceedingKind'
        administration_kind:
          description: >
            Kind of administration ordered for the proceeding. Null when
            unknown.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/InsolvencyAdministrationKind'
        insolvency_grounds:
          description: >
            Grounds for the insolvency (e.g. Zahlungsunfähigkeit,
            Überschuldung).
          type: array
          items:
            type: string
        distribution_claims_total:
          description: |
            Total registered claims in the distribution, in euros.
          type: number
          format: double
          nullable: true
        distribution_available:
          description: |
            Amount available for distribution, in euros.
          type: number
          format: double
          nullable: true
        current_status:
          $ref: '#/components/schemas/InsolvencyStatus'
        administrator_name:
          description: |
            Name of the insolvency administrator.
          type: string
          nullable: true
        administrator_address:
          description: |
            Address of the insolvency administrator.
          type: string
          nullable: true
        opened_at:
          description: |
            Date the proceeding was opened.
            Format: ISO 8601 (YYYY-MM-DD)
          type: string
          format: date
          nullable: true
        closed_at:
          description: |
            Date the proceeding was closed.
            Format: ISO 8601 (YYYY-MM-DD)
          type: string
          format: date
          nullable: true
        claims_filing_deadline:
          description: |
            Deadline for creditors to file their claims.
            Format: ISO 8601 (YYYY-MM-DD)
          type: string
          format: date
          nullable: true
        first_event_at:
          description: |
            Publication date of the first known event of the proceeding.
            Format: ISO 8601 (YYYY-MM-DD)
          type: string
          format: date
          nullable: true
        last_event_at:
          description: |
            Publication date of the most recent known event of the proceeding.
            Format: ISO 8601 (YYYY-MM-DD)
          type: string
          format: date
          nullable: true
        events:
          description: |
            All published events of the proceeding, ordered by date.
          type: array
          items:
            $ref: '#/components/schemas/InsolvencyEvent'
      required:
        - id
        - court
        - case_number
        - company_id
        - debtor_name
        - insolvency_grounds
        - current_status
        - events
    InsolvencyDebtorKind:
      type: string
      description: |
        Kind of debtor the proceeding concerns.
        - legal_person: legal entities (companies, associations, etc.)
        - natural_person: private individuals
      enum:
        - legal_person
        - natural_person
    InsolvencyProceedingKind:
      type: string
      description: |
        Kind of insolvency proceeding.
      enum:
        - regular_insolvency
        - consumer_insolvency
    InsolvencyAdministrationKind:
      type: string
      description: |
        Kind of administration ordered for the proceeding.
      enum:
        - external_administration
        - self_administration
        - protective_shield
    InsolvencyStatus:
      type: string
      description: |
        Current status of the insolvency proceeding.
      enum:
        - preliminary
        - opened
        - rejected_no_assets
        - mass_insufficient
        - plan_supervised
        - lifted
        - discontinued
        - discharge_pending
        - discharge_granted
        - discharge_denied
        - discharge_revoked
        - unknown
    InsolvencyEvent:
      type: object
      description: |
        A single published event of an insolvency proceeding, derived from an
        official court publication.
      properties:
        id:
          description: |
            Unique identifier of the event.
          type: string
          format: uuid
        event_type:
          $ref: '#/components/schemas/InsolvencyEventType'
        report_type:
          $ref: '#/components/schemas/InsolvencyReportType'
        decision_date:
          description: |
            Date of the court decision, if published.
            Format: ISO 8601 (YYYY-MM-DD)
          type: string
          format: date
          nullable: true
        effective_at:
          description: |
            Date the decision takes effect, if published.
          type: string
          format: date-time
          nullable: true
        published_at:
          description: |
            Date the event was published by the court.
            Format: ISO 8601 (YYYY-MM-DD)
          type: string
          format: date
        summary:
          description: |
            Short summary of the publication.
          type: string
        details:
          $ref: '#/components/schemas/InsolvencyEventDetails'
      required:
        - id
        - event_type
        - report_type
        - published_at
        - summary
        - details
    InsolvencyEventType:
      type: string
      description: |
        Lifecycle event type of the insolvency proceeding.
      enum:
        - preliminary_measures
        - preliminary_measures_lifted
        - proceedings_opened
        - rejected_insufficient_assets
        - in_proceeding_decision
        - mass_insufficiency_notified
        - distribution_announced
        - distribution_record_filed
        - final_distribution_announced
        - proceedings_lifted
        - proceedings_discontinued
        - proceedings_terminated
        - post_termination_decision
        - subsequent_distribution_ordered
        - discharge_pending
        - discharge_granted
        - discharge_denied
        - discharge_revoked
        - plan_confirmed
        - plan_supervision_ordered
        - plan_supervision_terminated
        - other
    InsolvencyReportType:
      type: string
      description: |
        Category of the official publication the event was derived from.
      enum:
        - security_measures
        - rejection_for_insufficiency_of_assets
        - openings
        - decisions_in_proceedings
        - misc
        - decisions_after_termination
        - distribution_lists
        - decisions_in_discharge_proceedings
        - supervised_insolvency_plans
    InsolvencyEventDetails:
      type: object
      description: |
        Structured details extracted from the publication, where available.
      properties:
        administrator_name:
          type: string
          nullable: true
        administrator_address:
          type: string
          nullable: true
        claims_filing_deadline:
          type: string
          nullable: true
        closed_at:
          type: string
          nullable: true
        discharge_granted:
          type: boolean
          nullable: true
        insolvency_grounds:
          type: array
          items:
            type: string
        distribution_claims_total:
          type: string
          nullable: true
        distribution_available:
          type: string
          nullable: true
        meetings:
          type: array
          items:
            $ref: '#/components/schemas/InsolvencyMeeting'
      required:
        - insolvency_grounds
        - meetings
    InsolvencyMeeting:
      type: object
      description: |
        A creditor meeting or hearing announced in the publication.
      properties:
        kind:
          type: string
        at:
          type: string
          nullable: true
        location:
          type: string
          nullable: true
      required:
        - kind
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |
        API Key Authentication
        Provide your API key as a Bearer token in the Authorization header.

````