TaxResidency

Table

Description: Holds tax residency information for a single jurisdiction. Note on Required Fields: Fields marked as 'Required' 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
country_code	string	The ISO 3166-1 alpha-2 country code of the tax jurisdiction. This is the two-letter country code (e.g., "ZA" for South Africa, "NL" for the Netherlands). The value should be in uppercase. See https://www.iso.org/iso-3166-country-codes.html for a full list. Required for verification.	No	None
tin	string	The Tax Identification Number (TIN) for the client in that jurisdiction. Required for verification.	No	None

Protobuf

syntax = "proto3";

package meshtrade.compliance.client.v1;

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

/*
   Holds tax residency information for a single jurisdiction.
   Note on Required Fields: Fields marked as 'Required' are essential
   for a successful compliance check, but are not mandatory for creation.
*/
message TaxResidency {
  /*
     The ISO 3166-1 alpha-2 country code of the tax jurisdiction.
     This is the two-letter country code (e.g., "ZA" for South Africa,
     "NL" for the Netherlands). The value should be in uppercase.
     See https://www.iso.org/iso-3166-country-codes.html for a full list.
     Required for verification.
  */
  string country_code = 1;

  /*
     The Tax Identification Number (TIN) for the client in that jurisdiction.
     Required for verification.
  */
  string tin = 2;
}