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

# Company information

## Get company information

Returns comprehensive company data including registration details, management, financial indicators, contact information, and complete historical changes.

**Cost:** 10 credits (20 credits with `realtime=true`)

### Realtime Parameter

Add `realtime=true` to fetch the latest data directly from the Handelsregister. Costs an additional 10 credits. Use for compliance checks or when you need guaranteed current data.

### Insolvency Data

When the company has insolvency proceedings, the response includes an `insolvencies` array with a summary of each proceeding. Use the [insolvency endpoint](/endpoint/insolvency) to retrieve the full event history of a proceeding.


## OpenAPI

````yaml GET /v1/company/{company_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/company/{company_id}:
    get:
      tags:
        - v1
      summary: Get detailed company information
      operationId: getCompanyV1
      parameters:
        - name: company_id
          in: path
          required: true
          description: |
            Unique company identifier.
            Example: DE-HRB-F1103-267645
          schema:
            type: string
        - name: realtime
          in: query
          required: false
          description: >
            Get the most up-to-date company information directly from the
            Handelsregister.

            When set to true, we fetch the latest data in real-time from the
            official German commercial register, ensuring you receive the most
            current company details.

            Note: Real-time requests take longer but guarantee the freshest data
            available.
          schema:
            type: boolean
        - name: export
          in: query
          required: false
          description: |
            Setting this to true will return the company without sources.
          schema:
            type: boolean
      responses:
        '200':
          description: Successfully retrieved company data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanyV1'
        '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 - Company 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.company.getDetailsV1('company_id');

            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.company.get_details_v1(
                company_id="company_id",
            )
            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.Company.GetDetailsV1(\n\t\tcontext.TODO(),\n\t\t\"company_id\",\n\t\topenregister.CompanyGetDetailsV1Params{},\n\t)\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", response.ID)\n}\n"
        - lang: CLI
          source: |-
            openregister company get-details-v1 \
              --api-key 'My API Key' \
              --company-id company_id
components:
  schemas:
    CompanyV1:
      type: object
      properties:
        id:
          type: string
          description: |
            Unique company identifier.
            Example: DE-HRB-F1103-267645
        register:
          $ref: '#/components/schemas/CompanyRegister'
          description: |
            Current registration information of the company.
        registers:
          description: |
            Historical registration changes.
            Shows how registration details changed over time.
          type: array
          items:
            $ref: '#/components/schemas/CompanyRegister'
        status:
          description: |
            Current status of the company:
            - active: Operating normally
            - inactive: No longer operating
            - liquidation: In the process of being dissolved
          type: string
          enum:
            - active
            - inactive
            - liquidation
        name:
          $ref: '#/components/schemas/CompanyName'
          description: |
            Current official name of the company.
        names:
          description: |
            Historical company names.
            Shows how the company name changed over time.
          type: array
          items:
            $ref: '#/components/schemas/CompanyName'
        address:
          $ref: '#/components/schemas/CompanyAddress'
          description: |
            Current registered address of the company.
        addresses:
          description: |
            Historical addresses.
            Shows how the company address changed over time.
          type: array
          items:
            $ref: '#/components/schemas/CompanyAddress'
        purpose:
          description: |
            Current official business purpose of the company.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/CompanyPurpose'
        purposes:
          description: |
            Historical business purposes.
            Shows how the company purpose changed over time.
          type: array
          items:
            $ref: '#/components/schemas/CompanyPurpose'
        capital:
          description: |
            Current registered capital of the company.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/CompanyCapital'
        capitals:
          description: |
            Historical capital changes.
            Shows how the company capital changed over time.
          type: array
          items:
            $ref: '#/components/schemas/CompanyCapital'
        representation:
          description: |
            List of individuals or entities authorized to represent the company.
            Includes directors, officers, and authorized signatories.
          type: array
          items:
            $ref: '#/components/schemas/CompanyRepresentativeV1'
        representation_rule:
          description: |
            The company's current general representation rule
            (allgemeine Vertretungsregelung), as published in the register.
            Example: "Ist nur ein Geschäftsführer bestellt, so vertritt er die
            Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird
            die Gesellschaft durch zwei Geschäftsführer oder durch einen
            Geschäftsführer gemeinsam mit einem Prokuristen vertreten."
          type: string
          nullable: true
        indicators:
          description: >
            Key company indicators like net income, employee count, revenue,
            etc..
          type: array
          items:
            $ref: '#/components/schemas/CompanyIndicatorSummary'
        legal_form:
          $ref: '#/components/schemas/CompanyLegalForm'
          description: |
            Legal form of the company.
            Example: "gmbh" for Gesellschaft mit beschränkter Haftung
        lei:
          description: |
            Legal Entity Identifier (LEI), if available.
          type: string
        documents:
          description: |
            Available official documents related to the company.
          type: array
          items:
            $ref: '#/components/schemas/CompanyDocument'
        incorporated_at:
          description: |
            Date when the company was officially registered.
            Format: ISO 8601 (YYYY-MM-DD)
            Example: "2022-01-01"
          type: string
          format: date
        notarized_at:
          description: >
            Date of the notarized company agreement (Gesellschaftsvertrag or
            Satzung).

            Format: ISO 8601 (YYYY-MM-DD)

            Example: "2021-12-21"
          type: string
          format: date
          nullable: true
        terminated_at:
          description: |
            Date when the company was officially terminated (if applicable).
            Format: ISO 8601 (YYYY-MM-DD)
            Example: "2024-01-01"
          type: string
          format: date
          nullable: true
        merged_into:
          description: |
            If the company ceased to exist through a merger (Verschmelzung),
            the company it was merged into.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/CompanyMergedInto'
        acquisitions:
          description: |
            Companies that were merged into this company
            (Verschmelzung durch Aufnahme, as the acquiring entity).
          type: array
          items:
            $ref: '#/components/schemas/CompanyAcquisition'
        asset_spin_offs:
          description: |
            Spin-offs (Ausgliederung, § 123 Abs. 3 UmwG) in which this company
            transferred assets to another company as the transferring entity.
          type: array
          items:
            $ref: '#/components/schemas/CompanyAssetSpinOff'
        profit_transfer_agreement:
          description: |
            The company's current profit and loss transfer agreement
            (Gewinnabführungsvertrag), if one exists. The referenced company
            is the parent receiving this company's profit (Organträger).
            Null if the company has no active agreement.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/CompanyProfitTransferAgreement'
        industry_codes:
          description: |
            Industry codes of the company.
          type: object
          properties:
            WZ2025:
              type: array
              items:
                $ref: '#/components/schemas/IndustryCode'
          required:
            - WZ2025
        contact:
          description: |
            Contact information of the company.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/Website'
        insolvencies:
          description: |
            Insolvency proceedings of the company, if any.
            Contains basic information per proceeding; use the insolvency
            endpoint to retrieve all events of a proceeding.
          type: array
          items:
            $ref: '#/components/schemas/CompanyInsolvencySummary'
        sources:
          description: |
            Sources of the company data.
          type: array
          items:
            $ref: '#/components/schemas/Source'
      required:
        - id
        - register
        - registers
        - status
        - name
        - names
        - address
        - addresses
        - purpose
        - purposes
        - capital
        - capitals
        - representation
        - representation_rule
        - indicators
        - legal_form
        - documents
        - incorporated_at
        - notarized_at
        - terminated_at
        - merged_into
        - acquisitions
        - asset_spin_offs
        - profit_transfer_agreement
        - industry_codes
        - contact
        - sources
    CompanyRegister:
      type: object
      properties:
        company_id:
          type: string
          description: |
            Unique company identifier.
            Example: DE-HRB-F1103-267645
        register_number:
          type: string
          description: |
            Registration number in the company register.
            Example: "230633"
        register_type:
          $ref: '#/components/schemas/CompanyRegisterType'
          description: |
            Type of register where the company is recorded.
            Example: "HRB" (Commercial Register B)
        register_court:
          type: string
          description: |
            Court where the company is registered.
            Example: "Berlin (Charlottenburg)"
        start_date:
          description: |
            Date when this registration information became effective.
            Format: ISO 8601 (YYYY-MM-DD)
            Example: "2022-01-01"
          type: string
          format: date
      required:
        - register_number
        - register_type
        - register_court
    CompanyName:
      type: object
      properties:
        name:
          description: |
            Official company name including any legal form designations.
            Example: "Descartes Technologies UG (haftungsbeschränkt)"
          type: string
        legal_form:
          $ref: '#/components/schemas/CompanyLegalForm'
          description: |
            Legal form of the company at this point in time.
            Example: "gmbh" for Gesellschaft mit beschränkter Haftung
        start_date:
          description: |
            Date when this name became effective.
            Format: ISO 8601 (YYYY-MM-DD)
            Example: "2022-01-01"
          type: string
          format: date
      required:
        - name
        - legal_form
        - start_date
    CompanyAddress:
      type: object
      properties:
        street:
          description: |
            Street name and number.
            Example: "Musterstraße 1"
          type: string
        city:
          description: |
            City or locality name.
            Example: "Berlin"
          type: string
        postal_code:
          description: |
            Postal or ZIP code.
            Example: "10117"
          type: string
        country:
          description: |
            Country name.
            Example: "Germany"
          type: string
        extra:
          description: |
            Additional address information such as c/o or attention line.
            Example: "c/o Max Mustermann"
          type: string
        start_date:
          description: |
            Date when this address became effective.
            Format: ISO 8601 (YYYY-MM-DD)
            Example: "2022-01-01"
          type: string
          format: date
        formatted_value:
          description: |
            Complete address formatted as a single string.
            Example: "Musterstraße 1, 10117 Berlin, Germany"
          type: string
      required:
        - city
        - country
        - start_date
        - formatted_value
    CompanyPurpose:
      type: object
      properties:
        purpose:
          description: >
            Official description of the company's business activities and
            objectives.

            This is the registered purpose as stated in official documents.
          type: string
        start_date:
          description: |
            Date when this purpose became effective.
            Format: ISO 8601 (YYYY-MM-DD)
            Example: "2022-01-01"
          type: string
          format: date
      required:
        - purpose
        - start_date
    CompanyCapital:
      type: object
      properties:
        amount:
          description: |
            Capital amount as a decimal number.
            Example: 100000.00 represents 100,000.00 monetary units
          type: number
          format: double
        currency:
          description: |
            Currency code for the capital amount.
            Example: "EUR" for Euro
          type: string
          enum:
            - EUR
            - DEM
            - USD
        start_date:
          description: |
            Date when this capital amount became effective.
            Format: ISO 8601 (YYYY-MM-DD)
            Example: "2023-01-01"
          type: string
          format: date
      required:
        - amount
        - currency
        - start_date
    CompanyRepresentativeV1:
      type: object
      properties:
        id:
          description: |
            Unique identifier for the representative.
            For companies: Format matches company_id pattern
            For individuals: UUID
            Example: "DE-HRB-F1103-267645" or UUID
            May be null for certain representatives.
          type: string
          nullable: true
        name:
          description: >-
            The name of the representative. E.g. "Max Mustermann" or "Max
            Mustermann GmbH"
          type: string
        type:
          $ref: '#/components/schemas/EntityType'
          description: Whether the representation is a natural person or a legal entity.
        role:
          $ref: '#/components/schemas/RepresentationRole'
          description: The role of the representation. E.g. "DIRECTOR"
        start_date:
          description: |
            Date when this representative role became effective.
            Format: ISO 8601 (YYYY-MM-DD)
            Example: "2022-01-01"
          type: string
          format: date
        end_date:
          description: |
            Date when this representative role ended (if applicable).
            Format: ISO 8601 (YYYY-MM-DD)
            Example: "2022-01-01"
          type: string
          format: date
          nullable: true
        authority:
          description: >
            The representative's current individual representation authority

            (individuelle Vertretungsbefugnis), as published in the register.

            Null if no special authority is recorded.

            Example: "einzelvertretungsberechtigt mit der Befugnis, im Namen der

            Gesellschaft mit sich im eigenen Namen Rechtsgeschäfte
            abzuschließen"
          type: string
          nullable: true
        legal_person:
          $ref: '#/components/schemas/CompanyRepresentativeV1LegalPerson'
        natural_person:
          $ref: '#/components/schemas/CompanyRepresentativeV1NaturalPerson'
      required:
        - id
        - name
        - type
        - role
        - start_date
        - end_date
        - authority
    CompanyIndicatorSummary:
      description: |
        A focused subset of the key company indicators for a given year.
        Values of the indicator are given in the smallest currency unit (cents).
        Example: 2099 represents €20.99 for monetary values.
        For non-monetary values (e.g., employees), the actual number.
      type: object
      properties:
        date:
          description: |
            Date to which this financial indicators apply.
            Format: ISO 8601 (YYYY-MM-DD)
            Example: "2022-01-01"
          type: string
          format: date
        report_id:
          description: The report id (source) of the indicators.
          type: string
          format: uuid
        balance_sheet_total:
          description: The balance sheet total of that year (in cents).
          type: integer
          format: int64
          nullable: true
        net_income:
          description: The net income of that year (in cents).
          type: integer
          format: int64
          nullable: true
        revenue:
          description: The revenue of that year (in cents).
          type: integer
          format: int64
          nullable: true
        cash:
          description: The cash of that year (in cents).
          type: integer
          format: int64
          nullable: true
        employees:
          description: The number of employees of that year.
          type: integer
          format: int64
          nullable: true
        equity:
          description: The equity of that year (in cents).
          type: integer
          format: int64
          nullable: true
        real_estate:
          description: The real estate of that year (in cents).
          type: integer
          format: int64
          nullable: true
        materials:
          description: The materials of that year (in cents).
          type: integer
          format: int64
          nullable: true
        pension_provisions:
          description: The pension provisions of that year (in cents).
          type: integer
          format: int64
          nullable: true
        salaries:
          description: The salaries of that year (in cents).
          type: integer
          format: int64
          nullable: true
        taxes:
          description: The taxes of that year (in cents).
          type: integer
          format: int64
          nullable: true
        liabilities:
          description: The liabilities of that year (in cents).
          type: integer
          format: int64
          nullable: true
        capital_reserves:
          description: The capital reserves of that year (in cents).
          type: integer
          format: int64
          nullable: true
      required:
        - date
        - report_id
        - balance_sheet_total
        - net_income
        - revenue
        - cash
        - employees
        - equity
        - real_estate
        - materials
        - pension_provisions
        - salaries
        - taxes
        - liabilities
        - capital_reserves
    CompanyLegalForm:
      type: string
      description: >
        Legal form of the company.

        Common German legal forms:

        - gmbh: Gesellschaft mit beschränkter Haftung (Limited Liability
        Company)

        - ag: Aktiengesellschaft (Stock Corporation)

        - ug: Unternehmergesellschaft (Entrepreneurial Company with limited
        liability)

        - ohg: Offene Handelsgesellschaft (General Partnership)

        - kg: Kommanditgesellschaft (Limited Partnership)

        - ev: Eingetragener Verein (Registered Association)
      enum:
        - ag
        - eg
        - ek
        - ev
        - ewiv
        - foreign
        - gbr
        - ggmbh
        - gmbh
        - kg
        - kgaa
        - unknown
        - llp
        - municipal
        - ohg
        - se
        - ug
    CompanyDocument:
      type: object
      properties:
        id:
          description: |
            Unique identifier for the document.
            Example: "f47ac10b-58cc-4372-a567-0e02b2c3d479"
          type: string
        type:
          description: |
            Categorization of the document:
            - articles_of_association: Company statutes/bylaws
            - sample_protocol: Standard founding protocol
            - shareholder_list: List of company shareholders
          type: string
          enum:
            - articles_of_association
            - sample_protocol
            - shareholder_list
        date:
          description: |
            Document publication or filing date.
            Format: ISO 8601 (YYYY-MM-DD)
            Example: "2022-01-01"
          type: string
          format: date
        latest:
          description: |
            Whether this is the latest version of the document_type.
          type: boolean
      required:
        - id
        - type
        - date
        - latest
    CompanyMergedInto:
      type: object
      properties:
        company_id:
          description: >
            Unique company identifier of the company this company was merged
            into.

            Example: DE-HRB-F1103-267645
          type: string
        name:
          description: |
            Current name of the company this company was merged into.
          type: string
        registration_date:
          description: |
            Date the merger was registered.
            Format: ISO 8601 (YYYY-MM-DD)
          type: string
          format: date
        agreement_date:
          description: |
            Date the underlying contract (Verschmelzungsvertrag) was concluded,
            as cited in the register entry. Null when the register text does
            not cite a contract date. Entries sharing an agreement_date belong
            to the same transaction.
            Format: ISO 8601 (YYYY-MM-DD)
          type: string
          format: date
          nullable: true
      required:
        - company_id
        - name
        - registration_date
        - agreement_date
    CompanyAcquisition:
      type: object
      properties:
        company_id:
          description: >
            Unique company identifier of the company that was merged into this
            company.

            Example: DE-HRB-F1103-267645
          type: string
        name:
          description: |
            Current name of the company that was merged into this company.
          type: string
        registration_date:
          description: |
            Date the merger was registered.
            Format: ISO 8601 (YYYY-MM-DD)
          type: string
          format: date
        agreement_date:
          description: |
            Date the underlying contract (Verschmelzungsvertrag) was concluded,
            as cited in the register entry. Null when the register text does
            not cite a contract date. Entries sharing an agreement_date belong
            to the same transaction.
            Format: ISO 8601 (YYYY-MM-DD)
          type: string
          format: date
          nullable: true
      required:
        - company_id
        - name
        - registration_date
        - agreement_date
    CompanyAssetSpinOff:
      type: object
      properties:
        company_id:
          description: |
            Unique company identifier of the company that received the assets.
            Example: DE-HRB-F1103-267645
          type: string
        name:
          description: |
            Current name of the company that received the assets.
          type: string
        registration_date:
          description: |
            Date the spin-off was registered.
            Format: ISO 8601 (YYYY-MM-DD)
          type: string
          format: date
        agreement_date:
          description: |
            Date the underlying contract (Ausgliederungsvertrag) was concluded,
            as cited in the register entry. Null when the register text does
            not cite a contract date. Entries sharing an agreement_date belong
            to the same transaction.
            Format: ISO 8601 (YYYY-MM-DD)
          type: string
          format: date
          nullable: true
      required:
        - company_id
        - name
        - registration_date
        - agreement_date
    CompanyProfitTransferAgreement:
      type: object
      properties:
        company_id:
          description: |
            Unique company identifier of the parent company receiving
            this company's profit (Organträger).
            Example: DE-HRB-F1103-267645
          type: string
        name:
          description: |
            Current name of the parent company.
          type: string
        registration_date:
          description: |
            Date the agreement was registered.
            Format: ISO 8601 (YYYY-MM-DD)
          type: string
          format: date
        agreement_date:
          description: >
            Date the underlying contract (Gewinnabführungsvertrag) was
            concluded,

            as cited in the register entry. Null when the register text does

            not cite a contract date. Entries sharing an agreement_date belong

            to the same transaction.

            Format: ISO 8601 (YYYY-MM-DD)
          type: string
          format: date
          nullable: true
      required:
        - company_id
        - name
        - registration_date
        - agreement_date
    IndustryCode:
      type: object
      description: |
        Industry codes from WZ 2025.
      properties:
        code:
          type: string
      required:
        - code
    Website:
      type: object
      properties:
        email:
          type: string
        phone:
          type: string
        vat_id:
          type: string
        website_url:
          type: string
        social_media:
          $ref: '#/components/schemas/SocialMediaLinks'
      required:
        - website_url
        - social_media
    CompanyInsolvencySummary:
      type: object
      description: |
        Basic information about an insolvency proceeding of the company.
        Use the insolvency endpoint to retrieve all events of the proceeding.
      properties:
        id:
          description: |
            Unique identifier of the insolvency proceeding.
          type: string
          format: uuid
        current_status:
          $ref: '#/components/schemas/InsolvencyStatus'
        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
        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'
        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
      required:
        - id
        - current_status
        - court
        - case_number
    Source:
      type: object
      properties:
        document_url:
          description: >
            Url of the source document. In the form of a presigned url
            accessible for 30 minutes.
          type: string
      required:
        - document_url
    CompanyRegisterType:
      type: string
      description: >
        Type of company register where the entity is recorded.

        Common types:

        - HRB: Commercial Register B (limited liability companies, stock
        corporations)

        - HRA: Commercial Register A (partnerships, sole proprietorships)

        - PR: Partnership Register

        - GnR: Cooperative Register

        - VR: Association Register
      enum:
        - HRB
        - HRA
        - PR
        - GnR
        - VR
    EntityType:
      type: string
      enum:
        - natural_person
        - legal_person
    RepresentationRole:
      type: string
      enum:
        - DIRECTOR
        - PROKURA
        - SHAREHOLDER
        - OWNER
        - PARTNER
        - PERSONAL_LIABLE_DIRECTOR
        - LIQUIDATOR
        - OTHER
    CompanyRepresentativeV1LegalPerson:
      type: object
      nullable: true
      properties:
        name:
          type: string
        city:
          type: string
          nullable: true
        country:
          description: >
            Country where the representative is located, in ISO 3166-1 alpha-2
            format.

            Example: "DE" for Germany
          type: string
      required:
        - name
        - city
        - country
    CompanyRepresentativeV1NaturalPerson:
      nullable: true
      type: object
      properties:
        city:
          description: |
            City where the representative is located.
            Example: "Berlin"
          type: string
          nullable: true
        first_name:
          description: |
            First name of the representative.
            Example: "Max"
          type: string
          nullable: true
        last_name:
          description: |
            Last name of the representative.
            Example: "Mustermann"
          type: string
          nullable: true
        date_of_birth:
          description: |
            Date of birth of the representative.
            May still be null for natural persons if it is not available.
            Format: ISO 8601 (YYYY-MM-DD)
            Example: "1990-01-01"
          type: string
          format: date
          nullable: true
      required:
        - city
        - first_name
        - last_name
        - date_of_birth
    SocialMediaLinks:
      type: object
      properties:
        linkedin:
          type: string
        instagram:
          type: string
        github:
          type: string
        twitter:
          type: string
        facebook:
          type: string
        youtube:
          type: string
        xing:
          type: string
        tiktok:
          type: string
    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
    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
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |
        API Key Authentication
        Provide your API key as a Bearer token in the Authorization header.

````