CompanyRepresentative

Table

Description: CompanyRepresentative models an individual acting in an official capacity for a legal entity. This person is typically subject to KYC verification as part of the overall KYB process for the legal entity they represent. Note on Field Requirements: Fields marked as 'Required for verification' are essential for a successful compliance check, but are not mandatory for creation.

note

The protobuf file is the authoritative source of documentation. Please refer to the Protobuf tab when in doubt about field definitions, validation rules, or type specifications.

Field	Type	Description	Required	Validation
natural_person	NaturalPerson	Details of the natural person that is the company representative. This contains the core personal identity information (name, residential address, ID document, personal contact details, etc.) required for their individual KYC check. Required for verification.	Yes	None
role	CompanyRepresentativeRole	The official role this person holds in relation to the company. Required for verification.	No	None
position	string	The person's job title or position within the company (e.g., "CEO", "Managing Partner"). Optional for verification.	No	None
ownership_percentage	Decimal	For UBOs and Shareholders, this specifies the percentage of ownership or voting rights. Should be a value between 0.0 and 100.0. Required by business logic if the role is ULTIMATE_BENEFICIAL_OWNER or SHAREHOLDER. Optional for verification.	Yes	None
professional_contact_details	ContactDetails	The professional contact details for the representative in their capacity at the company (e.g., work email, work phone). Optional for verification.	Yes	None
date_of_appointment	Date	The date when the person was appointed to this role. Optional for verification.	Yes	None

Protobuf

syntax = "proto3";

package meshtrade.compliance.client.v1;

import "google/type/date.proto";
import "meshtrade/compliance/client/v1/company_representative_role.proto";
import "meshtrade/compliance/client/v1/natural_person.proto";
import "meshtrade/type/v1/contact_details.proto";
import "meshtrade/type/v1/decimal.proto";

option go_package = "github.com/meshtrade/api/go/compliance/client/v1;clientv1";
option java_package = "co.meshtrade.api.compliance.client.v1";

/*
   CompanyRepresentative models an individual acting in an official capacity for a legal entity.
   This person is typically subject to KYC verification as part of the overall KYB process
   for the legal entity they represent.
   Note on Field Requirements: Fields marked as 'Required for verification' are essential
   for a successful compliance check, but are not mandatory for creation.
*/
message CompanyRepresentative {
  /*
     Details of the natural person that is the company representative.
     This contains the core personal identity information (name, residential address,
     ID document, personal contact details, etc.) required for their individual KYC check.
     Required for verification.
  */
  meshtrade.compliance.client.v1.NaturalPerson natural_person = 1;

  /*
     The official role this person holds in relation to the company.
     Required for verification.
  */
  meshtrade.compliance.client.v1.CompanyRepresentativeRole role = 2;

  /*
     The person's job title or position within the company (e.g., "CEO", "Managing Partner").
     Optional for verification.
  */
  string position = 3;

  /*
     For UBOs and Shareholders, this specifies the percentage of ownership or voting rights.
     Should be a value between 0.0 and 100.0.
     Required by business logic if the role is ULTIMATE_BENEFICIAL_OWNER or SHAREHOLDER.
     Optional for verification.
  */
  meshtrade.type.v1.Decimal ownership_percentage = 4;

  /*
     The professional contact details for the representative in their capacity at the company
     (e.g., work email, work phone).
     Optional for verification.
  */
  meshtrade.type.v1.ContactDetails professional_contact_details = 5;

  /*
     The date when the person was appointed to this role.
     Optional for verification.
  */
  google.type.Date date_of_appointment = 6;
}