Skip to main content
GET
/
companies
/
{id}
/
ownership-tree
Get company ownership hierarchy (tree)
curl --request GET \
  --url https://lens-api.tic.io/companies/{id}/ownership-tree \
  --header 'x-api-key: <api-key>'
{
  "companyId": 123,
  "placeholderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "registrationNumber": "<string>",
  "countryCode": "<string>",
  "isPlaceholder": true,
  "isSelected": true,
  "ownershipPercentage": 123,
  "numberOfShares": 123,
  "sources": [
    {
      "source": "<string>",
      "percentage": 123,
      "numberOfShares": 123,
      "numberOfVotes": 123,
      "shareClass": "<string>",
      "asOfDate": "2023-11-07T05:31:56Z",
      "validFrom": "2023-11-07T05:31:56Z",
      "validTo": "2023-11-07T05:31:56Z",
      "isCurrent": true
    }
  ],
  "children": "<array>",
  "parents": "<array>",
  "beneficialOwners": [
    {
      "personId": 123,
      "placeholderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "personalIdentityNumber": "<string>",
      "citizenshipCountryCode": "<string>",
      "countryOfResidenceCode": "<string>",
      "isPlaceholder": true,
      "extentCode": "<string>",
      "extentDescription": "<string>",
      "governCode": "<string>",
      "governDescription": "<string>",
      "intermediaryCompanyId": 123,
      "intermediaryCompanyName": "<string>",
      "validFrom": "2023-11-07T05:31:56Z",
      "validTo": "2023-11-07T05:31:56Z",
      "isCurrent": true,
      "source": "<string>"
    }
  ],
  "depth": 123
}
Max+ tier

Authorizations

x-api-key
string
header
required

Path Parameters

id
integer<int32>
required

Internal company ID

Query Parameters

direction
string
default:down

Direction of traversal: "up" (owners/ancestors), "down" (subsidiaries/owned), or "both". Default "down".

maxDepth
integer<int32>
default:10

Maximum traversal depth. Default 10.

currentOnly
boolean
default:true

When true, only current (non-historical) ownership edges are included. Default true.

Response

Ownership tree rooted at the company

companyId
null | integer<int32>
placeholderId
null | string<uuid>
name
null | string
registrationNumber
null | string
countryCode
null | string
isPlaceholder
boolean
isSelected
boolean
ownershipPercentage
null | number<double>
numberOfShares
null | integer<int32>
sources
null | object[]
children
null | array
parents
null | array
beneficialOwners
null | object[]
depth
integer<int32>