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

# Get Company Financial Reports With Extraction

> Get financial reports for a company and extract financial data if not already available.

This endpoint returns all financial reports for a company including:
- Report metadata (name, date, URLs)
- Extracted financial data (if available or extracted)
- Automatic extraction from HTML reports when data is missing



## OpenAPI

````yaml get /companies/{company_id}/financials
openapi: 3.1.0
info:
  title: Registercheck API
  version: 1.0.0
servers:
  - url: https://jobs-api.registercheck.de/api/v2
security: []
paths:
  /companies/{company_id}/financials:
    get:
      tags:
        - Companies
      summary: Get Company Financial Reports With Extraction
      description: >-
        Get financial reports for a company and extract financial data if not
        already available.


        This endpoint returns all financial reports for a company including:

        - Report metadata (name, date, URLs)

        - Extracted financial data (if available or extracted)

        - Automatic extraction from HTML reports when data is missing
      operationId: >-
        get_company_financial_reports_with_extraction_companies__company_id__financials_get
      parameters:
        - name: company_id
          in: path
          required: true
          schema:
            type: string
            title: Company Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanyFinancialReportsResponse'
        '404':
          description: Company or financial reports not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '500':
          description: Internal server error
      security:
        - HTTPBearer: []
components:
  schemas:
    CompanyFinancialReportsResponse:
      properties:
        company_id:
          type: string
          title: Company Id
          description: Unique identifier of the company
        company_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Company Name
          description: Name of the company
        financial_reports:
          items:
            $ref: '#/components/schemas/FinancialReportResponse'
          type: array
          title: Financial Reports
          description: List of financial reports for the company
      type: object
      required:
        - company_id
        - financial_reports
      title: CompanyFinancialReportsResponse
      description: Collection of financial reports for a specific company.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    FinancialReportResponse:
      properties:
        id:
          type: string
          title: Id
          description: Unique identifier for the financial report
        name:
          type: string
          title: Name
          description: Name or title of the financial report
        link:
          anyOf:
            - type: string
            - type: 'null'
          title: Link
          description: URL link to the original report
        date:
          anyOf:
            - type: string
            - type: 'null'
          title: Date
          description: Date of the financial report
        language:
          anyOf:
            - type: string
            - type: 'null'
          title: Language
          description: Language of the report (e.g., en, de)
        report_pdf_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Report Pdf Url
          description: URL to the PDF version of the report
        report_table_html_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Report Table Html Url
          description: URL to the HTML table version of the report
        is_consolidated:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Consolidated
          description: >-
            If true, the company does not have a separate financial report but
            is part of a consolidated financial report (ger.: hat
            Konzernabschluss)
        company_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Company Id
          description: Unique identifier of the company
        financial_data:
          anyOf:
            - $ref: '#/components/schemas/FinancialDataResponse'
            - type: 'null'
          description: Extracted and structured financial data
      type: object
      required:
        - id
        - name
      title: FinancialReportResponse
      description: Individual financial report with extracted data and metadata.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    FinancialDataResponse:
      properties:
        profit_loss:
          anyOf:
            - $ref: '#/components/schemas/ProfitLossResponse'
            - type: 'null'
          description: Profit and loss statement data
        assets:
          anyOf:
            - $ref: '#/components/schemas/AssetsResponse'
            - type: 'null'
          description: Balance sheet assets data
        liabilities:
          anyOf:
            - $ref: '#/components/schemas/LiabilitiesResponse'
            - type: 'null'
          description: Balance sheet liabilities and equity data
        meta:
          anyOf:
            - $ref: '#/components/schemas/MetaResponse'
            - type: 'null'
          description: Metadata about the financial report
        employees:
          anyOf:
            - type: integer
            - type: 'null'
          title: Employees
          description: Number of employees in the company
        financial_obligations:
          anyOf:
            - type: string
            - type: 'null'
          title: Financial Obligations
          description: Description of financial obligations or commitments
      type: object
      title: FinancialDataResponse
      description: >-
        Complete financial data for a company including profit/loss, balance
        sheet, and metadata.
    ProfitLossResponse:
      properties:
        revenue:
          anyOf:
            - type: number
            - type: 'null'
          title: Revenue
          description: Total revenue or sales for the period
        total_output:
          anyOf:
            - type: number
            - type: 'null'
          title: Total Output
          description: Total output including revenue and other income
        gross_profit:
          anyOf:
            - type: number
            - type: 'null'
          title: Gross Profit
          description: Revenue minus cost of goods sold
        personnel_expenses:
          anyOf:
            - type: number
            - type: 'null'
          title: Personnel Expenses
          description: Total employee-related costs including salaries and benefits
        depreciation:
          anyOf:
            - type: number
            - type: 'null'
          title: Depreciation
          description: Depreciation and amortization expenses
        other_operating_expenses:
          anyOf:
            - type: number
            - type: 'null'
          title: Other Operating Expenses
          description: Other operating expenses not categorized elsewhere
        ebit:
          anyOf:
            - type: number
            - type: 'null'
          title: Ebit
          description: Earnings Before Interest and Taxes
        ebitda:
          anyOf:
            - type: number
            - type: 'null'
          title: Ebitda
          description: Earnings Before Interest, Taxes, Depreciation, and Amortization
        financial_result:
          anyOf:
            - type: number
            - type: 'null'
          title: Financial Result
          description: Net financial result (financial income minus financial expenses)
        interest_and_similar_income:
          anyOf:
            - type: number
            - type: 'null'
          title: Interest And Similar Income
          description: Interest income and similar financial income
        interest_and_similar_expenses:
          anyOf:
            - type: number
            - type: 'null'
          title: Interest And Similar Expenses
          description: Interest expenses and similar financial costs
        income_taxes:
          anyOf:
            - type: number
            - type: 'null'
          title: Income Taxes
          description: Income tax expenses for the period
        net_income:
          anyOf:
            - type: number
            - type: 'null'
          title: Net Income
          description: Net profit after all expenses and taxes
        net_loss:
          anyOf:
            - type: number
            - type: 'null'
          title: Net Loss
          description: Net loss if the company was unprofitable
      type: object
      title: ProfitLossResponse
      description: |-
        Profit and loss statement (income statement) data for a company.
        Contains revenue, expenses, and profitability metrics.
    AssetsResponse:
      properties:
        total_assets:
          anyOf:
            - type: number
            - type: 'null'
          title: Total Assets
          description: Total assets (fixed assets + current assets)
        fixed_assets:
          anyOf:
            - type: number
            - type: 'null'
          title: Fixed Assets
          description: Long-term assets like property, plant, and equipment
        current_assets:
          anyOf:
            - type: number
            - type: 'null'
          title: Current Assets
          description: Short-term assets that can be converted to cash within a year
        cash_and_equivalents:
          anyOf:
            - type: number
            - type: 'null'
          title: Cash And Equivalents
          description: Cash on hand and highly liquid investments
      type: object
      title: AssetsResponse
      description: |-
        Balance sheet assets data for a company.
        Contains information about what the company owns.
    LiabilitiesResponse:
      properties:
        total_equity_and_liabilities:
          anyOf:
            - type: number
            - type: 'null'
          title: Total Equity And Liabilities
          description: Total equity and liabilities (should equal total assets)
        equity:
          anyOf:
            - type: number
            - type: 'null'
          title: Equity
          description: Total shareholder equity
        liabilities:
          anyOf:
            - type: number
            - type: 'null'
          title: Liabilities
          description: Total liabilities (debts and obligations)
        liabilities_to_shareholders:
          anyOf:
            - type: number
            - type: 'null'
          title: Liabilities To Shareholders
          description: Amounts owed to shareholders
        bank_loans:
          anyOf:
            - type: number
            - type: 'null'
          title: Bank Loans
          description: Outstanding bank loans and credit facilities
        subscribed_capital:
          anyOf:
            - type: number
            - type: 'null'
          title: Subscribed Capital
          description: Capital that shareholders have committed to invest
        capital_reserve:
          anyOf:
            - type: number
            - type: 'null'
          title: Capital Reserve
          description: Additional paid-in capital above par value
        provisions:
          anyOf:
            - type: number
            - type: 'null'
          title: Provisions
          description: Provisions for future liabilities and risks
      type: object
      title: LiabilitiesResponse
      description: |-
        Balance sheet liabilities and equity data for a company.
        Contains information about what the company owes and shareholder equity.
    MetaResponse:
      properties:
        currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Currency
          description: Currency code (e.g., EUR, USD, GBP)
        currency_unit:
          anyOf:
            - type: string
            - type: 'null'
          title: Currency Unit
          description: Currency unit multiplier (e.g., thousands, millions)
        year:
          anyOf:
            - type: integer
            - type: 'null'
          title: Year
          description: Reporting year for the financial data
        is_consolidated:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Consolidated
          description: Whether the report includes consolidated subsidiaries
        company_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Company Name
          description: Name of the company
        location:
          anyOf:
            - type: string
            - type: 'null'
          title: Location
          description: Location or jurisdiction of the company
        source:
          anyOf:
            - type: string
            - type: 'null'
          title: Source
          description: Source of the financial data
      type: object
      title: MetaResponse
      description: |-
        Metadata about the financial report.
        Contains contextual information about the financial data.
  securitySchemes:
    HTTPBearer:
      type: http
      description: Enter your API key
      scheme: bearer

````