{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "#/components/schemas/ShareholderContact", "title": "ShareholderContact", "properties": { "address": { "description": "The address of the person.", "$ref": "#/components/schemas/ViasAddress" }, "email": { "description": "The e-mail address of the person.", "type": "string" }, "fullPhoneNumber": { "description": "The phone number of the person provided as a single string. It will be handled as a landline phone.\nExamples: \"0031 6 11 22 33 44\", \"+316/1122-3344\", \"(0031) 611223344\"", "type": "string" }, "jobTitle": { "description": "Job title of the person. Required when the `shareholderType` is **Controller**.\n\nExample values: **Chief Executive Officer**, **Chief Financial Officer**, **Chief Operating Officer**, **President**, **Vice President**, **Executive President**, **Managing Member**, **Partner**, **Treasurer**, **Director**, or **Other**.", "type": "string" }, "name": { "description": "The name of the person.", "$ref": "#/components/schemas/ViasName" }, "personalData": { "description": "Contains information about the person.", "$ref": "#/components/schemas/ViasPersonalData" }, "phoneNumber": { "description": "The phone number of the person.", "$ref": "#/components/schemas/ViasPhoneNumber" }, "shareholderCode": { "description": "The unique identifier (UUID) of the shareholder entry.\n>**If, during an Account Holder create or update request, this field is left blank (but other fields provided), a new Shareholder will be created with a procedurally-generated UUID.**\n\n>**If, during an Account Holder create request, a UUID is provided, the creation of Account Holder will fail with a validation Error..**\n\n>**If, during an Account Holder update request, a UUID that is not correlated with an existing Shareholder is provided, the update of the Shareholder will fail.**\n\n>**If, during an Account Holder update request, a UUID that is correlated with an existing Shareholder is provided, the existing Shareholder will be updated.**\n", "type": "string" }, "shareholderReference": { "x-addedInVersion": "5", "description": "Your reference for the shareholder entry.", "type": "string" }, "shareholderType": { "description": "Specifies how the person is associated with the account holder. \n\nPossible values: \n\n* **Owner**: Individuals who directly or indirectly own 25% or more of a company.\n\n* **Controller**: Individuals who are members of senior management staff responsible for managing a company or organization.", "enum": [ "Controller", "Owner", "Signatory" ], "type": "string" }, "webAddress": { "description": "The URL of the person's website.", "type": "string" } }, "type": "object" }