Skip to content

PrvtId

Unique and unambiguous identification of a person, eg, passport, profession, relationship to creditor, nationality, citizenship, gender.

  • Is optional
  • Type: object

With the following properties:

PropertyTypeRequiredDescription
DtAndPlcOfBirthObjectOptionalDate and place of birth of a person.
OthrObjectOptionalUnique identification of an organization, as assigned by an institution, using an identification scheme.
GenderStringOptionalGender of the party. Supported values: Male, Female, Other.
ProfessionStringOptionalIndicates occupation of the sending party.
RelShipToDbtrStringOptionalIndicates relationship of the receiving party to the sending party.
NtltyStringOptionalIndicates country of nationality of the party. Use ISO Country Code for values.
ResidenceStringOptionalIndicates country of residence of the party. Use ISO Country Code for values.
CitizenshipObjectOptionalSupport for recording multiple values of citizenship of a party.

DtAndPlcOfBirth

With the following properties:

PropertyTypeRequiredDescription
BirthDtStringOptionalInformation that identifies the date of Birth in ISO Date format (YYYY-MM-DD) for the party. Format: date-time.
PrvcOfBirthStringOptionalInformation that locates and identifies the Province of birth for the party. Maximum length: 35 characters
CityOfBirthStringOptionalInformation that locates and identifies the city of birth for the party. Maximum length: 35 characters
CtryOfBirthReferenceOptionalInformation that locates and identifies the country of birth for the party, as defined by postal services. Use Alpha-2 Code as defined in the ISO CountryCode ISO 3166-1 list. Defined in #/definitions/country.

Othr

Unique identification of an organization, as assigned by an institution, using an identification scheme.

With the following properties:

PropertyTypeRequiredDescription
IdStringOptionalValue to be used to identify the party. Maximum length: 35 characters
IssrStringOptionalInformation for the Entity that assigns the identification. Maximum length: 35 characters
SchmeNmObjectOptionalName of the identification scheme.
DtOfIssStringOptionalDate of Issue for Passport. Format: date-time. This is classified as a 'soft' field.
DtOfExprStringOptionalDate of Expiry for Passport. Format: date-time. This is classified as a 'soft' field.
MrzNbStringOptionalMachine Reable Zone for Passport. Maximum length: 88 characters. Pattern: /([A-Z])([A-Z0-9<])([A-Z]{3})([A-Z<]{39})\n([A-Z0-9<]{9})([0-9])([A-Z]{3})([0-9]{6})([0-9])([MF<])([0-9]{6})([0-9])([A-Z0-9<]{14})([0-9])([0-9])/im. This is classified as a 'soft' field.
SchmeNm

With the following properties:

PropertyTypeRequiredDescription
CdStringOptionalList based on ISO20022 ExternalPersonIdentification1Code List 27-Aug-2021, the value of this property must be equal to one of the known values below.
PrtryStringOptionalField to support proprietary value. Maximum length: 35 characters
Cd Known Values
ValueDescription
ARNUAlien Registration Number
CCPTPassport Number
CUSTCustomer Identification Number
DRLCDrivers License Number
EMPLEmployee Identification Number
NIDNNational Identity Number
SOSSocial Security Number
TELETelephone Number
TXIDTax Identification Number

Gender

PropertyTypeRequiredDescription
GenderStringOptionalGender of the party. Supported values: Male, Female, Other.

Profession

PropertyTypeRequiredDescription
ProfessionStringOptionalOccupation of the sending party.

RelShipToDbtr Known Values

ValueDescription
CHILChild
CUSTCustomer
EMPLEmployee
EXSPEx-spouse
FRENFriend
OTHROther
PAREParent
PARTBusiness partner
RELARelation
SELFSelf
SIBLSibling
SPOUCovering Spouse/Partner
VENDVendor

Ntlty

PropertyTypeRequiredDescription
NtltyStringOptionalIndicates country of nationality of the party. Use ISO Country Code for values.

Residence

PropertyTypeRequiredDescription
ResidenceStringOptionalIndicates country of residence of the party. Use ISO Country Code for values.

Citizenship

Support for recording multiple values of citizenship of a party.

With the following properties:

PropertyTypeRequiredDescription
NtltyStringOptionalIndicates nationality of the party. Use ISO Country Code for values.
MnrIdStringOptionalIndicates whether the party is a minor. Provide a value of Yes or No.
StartDtStringOptionalInformation that identifies the start date of citizenship in ISO Date format (YYYY-MM-DD) for the party. Format: date-time.
EndDtStringOptionalInformation that identifies the end date of citizenship in ISO Date format (YYYY-MM-DD) for the party. Format: date-time.

JSON schema extract

Click to expand
"PrvtId": {
	"type": "object",
	"description": "Unique and unambiguous identification of a person, eg, passport.",
	"properties": {
	    "DtAndPlcOfBirth": {
	        "type": "object",
	        "description": "Date and place of birth of a person.",
	        "properties": {
	            "BirthDt": {
	                "description": "Information that identifies the date of Birth in ISO Date format (YYYY-MM-DD) for the party.",
	                "type": "string",
	                "format": "date-time"
	            },
	            "PrvcOfBirth": {
	                "description": "Information that locates and identifies the Province of birth for the party.",
	                "type": "string",
	                "maxLength": 35
	            },
	            "CityOfBirth": {
	                "description": "Information that locates and identifies the city of birth for the party.",
	                "type": "string",
	                "maxLength": 35
	            },
	            "CtryOfBirth": {
	                "description": "Information that locates and identifies the country of birth for the party, as defined by postal services. Use Alpha-2 Code as defined in the ISO CountryCode ISO 3166-1 list.",
	                "$ref": "#/definitions/country"
	            }
	        }
	    },
	    "Othr": {
	        "type": "object",
	        "properties": {
	            "Id": {
	                "description": "Value to be used to identify the party",
	                "type": "string",
	                "maxLength": 35
	            },
	            "Issr": {
	                "description": "Information for the Entity that assigns the identification.",
	                "type": "string",
	                "maxLength": 35
	            },
	            "SchmeNm": {
	                "type": "object",
	                "description": "Name of the identification scheme.",
	                "properties": {
	                    "Cd": {
	                        "type": "string",
	                        "description": "List based on ISO20022 ExternalPersonIdentification1Code List 29May2020",
	                        "enum": [
	                            "ARNU",
	                            "CCPT",
	                            "CUST",
	                            "DRLC",
	                            "EMPL",
	                            "NIDN",
	                            "SOS",
	                            "TELE",
	                            "TXID"
	                        ]
	                    },
	                    "Prtry": {
	                        "type": "string",
	                        "description": "Field to support proprietary value",
	                        "maxLength": 35
	                    }
	                }
	            },
	            "DtOfIss": {
	                "type": "string",
	                "description": "Date of Issue for Passport",
	                "format": "date-time"
	            },
	            "DtOfExpr": {
	                "type": "string",
	                "description": "Date of Expiry for Passport",
	                "format": "date-time"
	            },
	            "MrzNb": {
	                "description": "Machine Reable Zone for Passport",
	                "type": "string",
	                "maxLength": 88,
	                "pattern": "/([A-Z])([A-Z0-9<])([A-Z]{3})([A-Z<]{39})\n([A-Z0-9<]{9})([0-9])([A-Z]{3})([0-9]{6})([0-9])([MF<])([0-9]{6})([0-9])([A-Z0-9<]{14})([0-9])([0-9])/im"
	            }
	        }
	    },
			"Gender":{
					"description": "Information that captures the ender of a party. Supported values: Male, Female, Other.",
					"type": "string",
					"maxLength": 6
			},
			"Profession": {
					"description": "Information that captures the occupation of a party.",
					"type": "string",
					"maxLength": 35
			},
			"RelShipToDbtr": {
					"description": "Relationship of the receiving party to the sending party.",
					"type": "string",
					"enum":[
							"CHIL",
							"EMPL",
							"FREN",
							"OTHR",
							"PARE",
							"RELA",
							"SELF",
							"SPOU",
							"VEND"
					]
			},
			"Ntlty": {
					"description": "Country of nationality of the party. Use ISO Country Code for value.",
					"type": "string",
					"maxLength": 3
			},
			"Residence": {
					"description": "Country of residence of the party. Use ISO Country Code for value.",
					"type": "string",
					"maxLength": 3
			},
			"Citizenship": {
	        "type": "object",
	        "properties": {
	            "Ntlty": {
	                "description": "Nationality of the party. Use ISO Country Code for values.",
	                "type": "string",
	                "maxLength": 3
	            },
	            "MnrId": {
	                "description": "Indicates whether the party is a minor. Provide a value of Yes or No.",
	                "type": "string",
	                "maxLength": 3
	            },
							"StartDt": {
	                "description": "Start date of citizenship in ISO Date format (YYYY-MM-DD) for the party.",
	                "type": "string",
	                "format": "date-time"
	            },
							"EndDt": {
	                "description": "End date of citizenship in ISO Date format (YYYY-MM-DD) for the party.",
	                "type": "string",
	                "format": "date-time"
	            }
					 }
				}
		}
}