Relationship¶

The Relationship object represents a connection between entities: officers, shareholders, beneficial owners, and similar roles. The related party is typically found in the parent entity’s counterparties array, referenced by _parentId.

Fields¶

Field	Type	Description
`_parentId`	string	ID of the related entity (references a counterparty)
`natureOfRelationship`	string	See Relationship types
`role`	string	Specific role title (e.g. `Director`, `Secretary`, `CEO`)
`shareholding`	Shareholding	Ownership percentage details (for shareholders)
`votingRights`	VotingRights	Voting rights details when available
`date_from`	string	Start date of the relationship when available

Shareholding object¶

Field	Type	Description
`directShareholdingPercentageOwned`	number	Exact ownership percentage
`minDirectShareholdingPercentageOwned`	number	Minimum ownership percentage (range)
`maxDirectShareholdingPercentageOwned`	number	Maximum ownership percentage (range)

VotingRights object¶

Field	Type	Description
`directVotingRightsPercentage`	number	Exact voting rights percentage
`minDirectVotingRightsPercentage`	number	Minimum (range)
`maxDirectVotingRightsPercentage`	number	Maximum (range)

Relationship types¶

Value	Description
`Officer`	Director, secretary, or other corporate officer
`Shareholder`	Owner of shares in the entity
`Beneficial Owner`	Ultimate beneficial owner
`Auditor`	Appointed auditor
`Liquidator`	Appointed liquidator
`Representative`	Legal or authorized representative
`Member`	Member of the entity (e.g. LLC members)
`Partner`	Partner
`Supervisory Board Member`	Supervisory board member
`Treasurer`	Treasurer
`Trustee`	Trustee

Example¶

{
  "_parentId": "counterparty-uuid",
  "natureOfRelationship": "Shareholder",
  "role": "Shareholder",
  "shareholding": {
    "directShareholdingPercentageOwned": 25.5
  }
}