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

# Ownership tree

> Retrieves a tree representing the group of companies

Returns a tree representing what's known about the ownership of the group of companies. Each node and company contains
up-to-date information about the company. The field, isSelected, will be set to true for the requested companyId to simplify
highlighting.

<Note>
  This is a recursive cached endpoint meaning expect large responses for
  companies included in a large group. Also expect response times between 0-5000
  ms depending on size of the tree and if it's cached or not. Therefore set your
  request timeout to 5000 ms.
</Note>

## Sources

Trees are built from the following sources:

1. Annual reports
2. Records of beneficial ownership
3. Registered information for the group of companies at SCB

## Accurancy

There is no requirement for companies to register the structure of the group of companies with any authority in Sweden. This
means that the information acquired from an annual report could be outdated or deviate against the actual ownership records
a few months later.

There is a flag in the root object called, deviationExists, which marks if the tree structure cannot be validated
against information the company has registered with SCB (Swedish: Statistikmyndigheten).

## Update frequency

We continuously make updates based on new filings of annual reports, changes of beneficial ownership and registered information at SCB
and reports from companies themself or our users.


## OpenAPI

````yaml get /datasets/companies/{companyId}/tree
openapi: 3.0.4
info:
  title: TIC API
  description: ''
  version: v1
servers:
  - url: https://api.tic.io/
security:
  - ApiKey: []
tags:
  - name: BolagsverketStatistics
  - name: Companies
  - name: Companies_SE_
  - name: DocumentDelivery
  - name: EuropeanCommission
  - name: FinancialDocuments
  - name: Finansinspektionen
  - name: Free
  - name: ICA
  - name: ICAStatistics
  - name: Lists
  - name: Media
  - name: Persons
  - name: Persons_SE_
  - name: Properties_SE_
  - name: PTSPortings
  - name: Reseller
  - name: SearchBankruptciesReports
  - name: SearchCompanies
  - name: SearchCompaniesReports
  - name: SearchCompanyWorkplaces
  - name: SearchPerson
  - name: SearchProperties_SE_
  - name: SearchVehicles
  - name: TeamDocumentOrders
  - name: Teams
  - name: User
  - name: Vehicles_SE_
  - name: WatchLists
paths:
  /datasets/companies/{companyId}/tree:
    get:
      tags:
        - Companies
      summary: Ownership tree
      description: Retrieves a tree representing the group of companies
      operationId: CompanyTree
      parameters:
        - name: companyId
          in: path
          description: The company id
          required: true
          schema:
            type: integer
            format: int32
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Ormeo_Library_Dtos_CompanyTree_Dto'
        '404':
          description: Not Found
components:
  schemas:
    Ormeo_Library_Dtos_CompanyTree_Dto:
      type: object
      properties:
        companyId:
          type: integer
          format: int32
          nullable: true
        isSelected:
          type: boolean
        name:
          type: string
          nullable: true
        lastCompanyStatusType:
          $ref: '#/components/schemas/Ormeo_Library_Entities_CompanyStatusType'
        lastCompanyStatusDate:
          type: string
          format: date-time
          nullable: true
        intelligenceScoreTotal:
          type: integer
          format: int32
          nullable: true
        intelligenceNumberOfMax:
          type: integer
          format: int32
          nullable: true
        kfm_DebtBalanceTotalAmountInSEK:
          type: number
          format: double
          nullable: true
        kfm_RecordOfNonPaymentNumberOfCases:
          type: integer
          format: int32
          nullable: true
        registrationNumber:
          type: string
          nullable: true
        countryCode:
          type: string
          nullable: true
        isCeased:
          type: boolean
          nullable: true
        ceasedDate:
          type: string
          format: date-time
          nullable: true
        ownedPercentage:
          type: integer
          format: int32
          nullable: true
        descendants:
          type: array
          items:
            $ref: '#/components/schemas/Ormeo_Library_Dtos_CompanyTree_Dto'
          nullable: true
        deviationExists:
          type: boolean
      additionalProperties: false
    Ormeo_Library_Entities_CompanyStatusType:
      enum:
        - reorganizationOfBusinessCommenced
        - bankruptcyTerminatedWithSurplus
        - dissolvedByCompanyDemerger
        - liquidationTerminated
        - mergerProcedureCommenced
        - acquisitionByCompanyDemerger
        - acquisitionByMerger
        - dissolvedByMergerProcedure
        - liquidationDecided
        - bankruptcyProceedingsCommenced
        - bankruptcyProceedingsTerminated
        - mergerPermitted
        - unused1
        - unused2
        - unused3
        - liquidationContinues
        - struckOffRegisterCrossBorderMerger
        - bankruptcyRepealedByCourt
        - liquidationEnds
        - liquidationRepealedByCourt
        - companyStruckOff
        - reorganizationOfBusinessEnded
        - reorganizationOfBusinessRepealedByCourt
        - resolutionCommenced
        - resolutionTerminated
        - resolutionRepealedByCourt
        - companyStruckOffTradeRegisterAct
        - deregisteredNewHolder
        - deregistered
        - reintroduced
        - companyStruckOffOwnRequest
        - companyStruckOffByRegistrationOffice
        - companyStruckOffReenteredAsJointStock
        - branchStruckOffForeignLiquidationOrBankruptcy
        - branchStruckOffOperationsCeased
        - branchStruckOffMissingCEO
        - branchStruckOffCourtOrder
        - branchStruckOffAnnualReportMissing
        - isActive
        - isNoLongerActive
        - hasNeverBeenActive
        - taxAuthorityStatus
        - companyDemergerCommenced
        - settlementNegotiationsCommenced
        - settlementNegotiationsTerminated
        - settlementNegotiationsRepealedByCourt
        - acquisitionExpired
        - acquisitionTerminated
        - acquisitionByMultipleMergers
        - acquisitionRepealedByCourt
        - mergerExpired
        - mergerRepealedByCourt
        - other
      type: string
  securitySchemes:
    ApiKey:
      type: apiKey
      name: x-api-key
      in: header

````