GET
/
datasets
/
companies
/
{companyId}
/
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": [
    {}
  ],
  "deviationExists": true
}

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
required

The company id

Response

200
application/json

OK

The response is of type object.