Companies
Get ownership/role graph for a company
Returns a progressive ORB (Ownership, Roles, Beneficial owners) graph centred on the company. Optional flags toggle beneficial-owner edges and visual risk highlighting. Node and role-expansion limits protect against explosively large graphs.
Max+ tier
GEThttps://lens-api.tic.io/companies/{id}/graph
Authorization
x-api-keystringheaderrequiredYour API key, sent in the x-api-key header.
Path parameters
idintegerrequiredInternal company ID
Query parameters
includeBeneficialOwnerbooleanInclude beneficial-owner edges
highlightDebtBalancebooleanHighlight nodes with outstanding KFM debt balances
highlightRecordOfNonPaymentbooleanHighlight nodes with KFM records of non-payment
limitMaxRoleInCompaniesintegerMaximum number of companies to expand per role. Default 300.
maxTotalNodesintegerMaximum total nodes in the returned graph. Default 10 000.
Responses
ORB graph · application/json
edgesORBEdge[] | nullHide child attributes
idstring | nullstartstring | nullendstring | nulllabelstring | nullpropertiesobject | nullShow child attributes
nodesORBNode[] | nullHide child attributes
idstring | nulllabelstring | nullpropertiesobject | nullShow child attributes
isTruncatedbooleanmaxNodesLimitinteger | nulltruncatedAtStagestring | nullnetworkRiskNetworkRiskHide child attributes
scorenumbertotalCompaniesintegerhighRiskCompaniesintegerhighRiskCompaniesPercentnumbertotalPersonsintegerhighlightedPersonsintegerhighlightedPersonsPercentnumberdetailsNetworkRiskDetail[] | nullShow child attributes
typestring | nullidstring | nullnamestring | nullintelligenceScoreTotalnumber | nullhighlightboolean | nullwatchlistsGraphWatchlist[] | nullHide child attributes
watchlistGuidstringwatchlistNamestring | nullCompany not found or not accessible