Skip to main content
GET
/
datasets
/
companies
/
{companyId}
/
tree
Ownership tree
curl --request GET \
  --url https://api.tic.io/datasets/companies/{companyId}/tree \
  --header 'x-api-key: <api-key>'
{
  "companyId": 123,
  "isSelected": true,
  "name": "<string>",
  "lastCompanyStatusType": "reorganizationOfBusinessCommenced",
  "lastCompanyStatusDate": "2023-11-07T05:31:56Z",
  "intelligenceScoreTotal": 123,
  "intelligenceNumberOfMax": 123,
  "kfm_DebtBalanceTotalAmountInSEK": 123,
  "kfm_RecordOfNonPaymentNumberOfCases": 123,
  "registrationNumber": "<string>",
  "countryCode": "<string>",
  "isCeased": true,
  "ceasedDate": "2023-11-07T05:31:56Z",
  "ownedPercentage": 123,
  "descendants": "<array>",
  "deviationExists": true
}

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.

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

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

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
companyId
integer<int32>
required

The company id

Response

OK

​
companyId
integer<int32> | null
​
isSelected
boolean
​
name
string | null
​
lastCompanyStatusType
enum<string>
Available options:
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
​
lastCompanyStatusDate
string<date-time> | null
​
intelligenceScoreTotal
integer<int32> | null
​
intelligenceNumberOfMax
integer<int32> | null
​
kfm_DebtBalanceTotalAmountInSEK
number<double> | null
​
kfm_RecordOfNonPaymentNumberOfCases
integer<int32> | null
​
registrationNumber
string | null
​
countryCode
string | null
​
isCeased
boolean | null
​
ceasedDate
string<date-time> | null
​
ownedPercentage
integer<int32> | null
​
descendants
array | null
​
deviationExists
boolean