Get company ownership hierarchy (tree)

Max+ tier

GEThttps://lens-api.tic.io/companies/{id}/ownership-tree

Authorization

x-api-keystringheaderrequired

Your API key, sent in the x-api-key header.

Path parameters

idintegerrequired

Internal company ID

format: int32

Query parameters

directionstring

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

default: "down"

maxDepthinteger

Maximum traversal depth. Default 10.

format: int32 · default: 10

currentOnlyboolean

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

default: true

Responses

Ownership tree rooted at the company · application/json

companyIdinteger | null

format: int32

placeholderIdstring | null

format: uuid

namestring | null

registrationNumberstring | null

countryCodestring | null

isPlaceholderboolean

isSelectedboolean

ownershipPercentagenumber | null

format: double

numberOfSharesinteger | null

format: int32

sourcesOwnershipSourceInfo_Dto[] | null

Hide child attributes

sourcestring | null

percentagenumber | null

format: double

numberOfSharesinteger | null

format: int32

numberOfVotesinteger | null

format: int32

shareClassstring | null

asOfDatestring | null

format: date-time

validFromstring | null

format: date-time

validTostring | null

format: date-time

isCurrentboolean

childrenCompanyOwnershipTree_Dto[] | null

parentsCompanyOwnershipTree_Dto[] | null

beneficialOwnersBeneficialOwnerNode_Dto[] | null

Hide child attributes

personIdinteger | null

format: int32

placeholderIdstring | null

format: uuid

namestring | null

personalIdentityNumberstring | null

citizenshipCountryCodestring | null

countryOfResidenceCodestring | null

isPlaceholderboolean

extentCodestring | null

extentDescriptionstring | null

governCodestring | null

governDescriptionstring | null

intermediaryCompanyIdinteger | null

format: int32

intermediaryCompanyNamestring | null

validFromstring | null

format: date-time

validTostring | null

format: date-time

isCurrentboolean

sourcestring | null

depthinteger

format: int32

{ "companyId": 123, "placeholderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "<string>", "registrationNumber": "<string>", "countryCode": "<string>", "isPlaceholder": true, "isSelected": true, "ownershipPercentage": 123.45, "numberOfShares": 123, "sources": [ { "source": "<string>", "percentage": 123.45, "numberOfShares": 123, "numberOfVotes": 123, "shareClass": "<string>", "asOfDate": "2026-01-15T10:30:00Z", "validFrom": "2026-01-15T10:30:00Z", "validTo": "2026-01-15T10:30:00Z", "isCurrent": true } ], "children": [ null ], "parents": [ null ], "beneficialOwners": [ { "personId": 123, "placeholderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "<string>", "personalIdentityNumber": "<string>", "citizenshipCountryCode": "<string>", "countryOfResidenceCode": "<string>", "isPlaceholder": true, "extentCode": "<string>", "extentDescription": "<string>", "governCode": "<string>", "governDescription": "<string>", "intermediaryCompanyId": 123, "intermediaryCompanyName": "<string>", "validFrom": "2026-01-15T10:30:00Z", "validTo": "2026-01-15T10:30:00Z", "isCurrent": true, "source": "<string>" } ], "depth": 123 }