Shareholders

Workflows > Endpoints > Contacts > Shareholders


Purpose: Manage shareholder records on customer and supplier contacts.

This endpoint is typically used in integrations that handle customer/supplier onboarding, AML compliance, or quality assurance routines that require ownership documentation. A shareholder is either a natural person or another organization, and the IsPerson property determines which set of fields applies to the entry.

The endpoint operates exclusively on contacts of type customer or supplier — employee contacts cannot have shareholders. Visibility in the GET endpoint is also limited to contacts that have an active customer or supplier sub-ledger account.

When the contact is a customer, CustomerAccountSubLedgerId is populated on the response. For suppliers, SupplierAccountSubLedgerId is populated. This allows correlation with subledger entries if needed for audit or reporting purposes.

Endpoint

Description of core flow

  1. Identify the contact using the Customers or Suppliers endpoint to retrieve the contactId.

  2. Query existing shareholders on the contact with GET /ContactShareholders?contactIds={contactId} to check current state and determine if the shareholder already exists.

  3. For each new shareholder, POST to /ContactShareholders/{contactId}:

    • For a person: set IsPerson: true, provide FirstName, LastName, optionally IdNumber, and the compliance flags IsPep/IsRca

    • For an organization: set IsPerson: false, provide Name and optionally OrgNumber

  4. Set the Share property as a decimal between 0 and 1 (e.g. 0.50 for 50% ownership).

Prerequisites

  • ContactShareholder (read-only) — query shareholder data

  • ContactShareholder_Full — create, update, and delete shareholders for any contact type

  • Customer / Customer_Full — read/write access scoped to customer-typed contacts (privileges are OR'd with ContactShareholder at the endpoint level)

  • Supplier / Supplier_Full — read/write access scoped to supplier-typed contacts (privileges are OR'd with ContactShareholder at the endpoint level)


Related workflows:


Dictionary/Terminology:

  • Shareholder: A person or organization holding ownership in a customer or supplier organization.

  • Beneficial owner: A shareholder whose ownership exceeds a regulatory threshold (typically 25% under Norwegian AML rules), making them subject to disclosure requirements.

  • PEP (Politically Exposed Person): An individual who holds or has held a prominent public function and is therefore considered higher risk for money laundering and corruption.

  • RCA (Relative or Close Associate of a PEP): An individual with a close personal or professional relationship to a PEP, treated with similar enhanced due diligence.

  • IsPerson: Boolean property determining whether the shareholder is documented as a natural person or as an organization. Cannot be modified after creation.

  • Share: Ownership fraction expressed as a decimal between 0 and 1.

  • Subledger: Customer or supplier sub-account where transactions related to that contact are posted.