Skip to main content
Search

PII Verify Fields

Sometimes, companies using GTR Solution must complete personal identity verification in advance. In order to meet the needs of due diligence, we additionally support optional fields called: Verify Fields.

For Travel Rule Request Initiator, they will bring out the fields expectVerifyFields they want to check for verification. And put the expectVerifyFields in request payload, for example: Initiator API 5: PII Verification, you can bring the parameter

*Travel Rule Request Initiator could be Originator VASP or Beneficiary VASP.

{
"requestId": "[YOUR REQUEST ID]",
"ticker": "ETC",
"address": "0x41ebF291D8BFb6481B4Ab1E26c412A96484b1454",
"tag": "",
"verifyType": 2,
"network": "xxxxxxxx",
"beneficiaryVasp": "xxxxxxx",
"encryptedPayload": "[YOUR PAYLOAD]",
"originatorPublicKey": "[YOUR PUBLIC KEY]",
"beneficiaryPublicKey": "[BENEFICIARY PUBLIC KEY]",
"fiatName": "USD",
"amount": "1000",
"fiatPrice": "6.66",
"lawThresholdEnabled": true,
"expectVerifyFields": [
"111001", // Beneficiary Legal Person Name
"110026" // Beneficiary Natural Person Name
]
}

For the Target VASP, they need to verify all the fields they can verify and bring out the results. And put the results into stage 3: receive PII results callback, for example: Receiver Callback API 3: PII Verification.

{
"verifyStatus": 100000,
"verifyMessage": "Success",
"data": {
"encryptedPayload": "....",
"verifyFields": [
{
"type": "110026", // Beneficiary Natural Person Name
"status": 1,
"message": "match"
}
]
//...
}
// ...
}

GTR will return based on the fields mentioned by Initiator instead of returning all the verification of the Beneficiary. In other words, the verification field result obtained by Initiator is an Intersection.

For the verifying fields, we provide the list that you could refer to, if the field is not in the list, you still can name it, please use UPPER snake case to name it.

Common Type Name:

NameFATF NameJSON PathGTR Enum
Beneficiary Legal Person NameLegalPersonNamex.ivms101.Beneficiary.beneficiaryPersons[].legalPerson.name.nameIdentifier111001
Beneficiary Natural Person NameNaturalPersonNameIDx.ivms101.Beneficiary.beneficiaryPersons[].naturalPerson.name.nameIdentifier110026
Beneficiary Natural Person Local NameLocalNaturalPersonNameIDx.ivms101.Beneficiary.beneficiaryPersons[].naturalPerson.na
Local Name is the non-english alphabet nameme.localNameIdentifier
110027
Beneficiary Natural Person Place of BirthPlaceOfBirthx.ivms101.Beneficiary.beneficiaryPersons[].naturalPerson.dateAndPlaceOfBirth.placeOfBirth110024
Beneficiary Natural Person Date of BirthDateOfBirthx.ivms101.Beneficiary.beneficiaryPersons[].naturalPerson.dateAndPlaceOfBirth.dateOfBirth110025
Beneficiary Natural Person Phonetic NameLocalNaturalPersonNameIDx.ivms101.Beneficiary.beneficiaryPersons[].naturalPerson.name.phoneticNameIdentifier110028
Beneficiary Natural Person Country Of ResidenceCountryOfResidencex.ivms101.Beneficiary.beneficiaryPersons[].naturalPerson.countryOfResidence110048
Beneficiary Legal Person Country Of RegistrationCountryOfRegistrationx.ivms101.Beneficiary.beneficiaryPersons[].legalPerson.countryOfRegistration111022

*Verify Fields code names are distinguished by Originator/Beneficiary and need to be used in different scenarios.

Status Enum Type:

Status Enum NameStatus Enum Value (Integer)Description
SKIP0GTR Response No Verify
MATCH / PASS1Full match Or Pass
MISMATCH2Not match
NOT_SUPPORT3Counter-Party VASP Response No Verify
REQUIRED_INFO_MISSING4Required Info missing (Required by the receiving VASP, but the field is missing)
REQUIRED_INFO_EXISTS5Received / Exists (Required by the receiving VASP; the field is present, but it cannot be verified because KYC/B does not support this field)

The error message will also give the Travel Rule Initiator two forms of information, one is the verification result expected by the Initiator, and the other is the verification result expected by the Receiver.

In Travel Rule Request Initiator​

Among them, SKIP, MATCH/PASS, MISMATCH, NOT_SUPPORT will only appear in the expectVerifyFields required by the Initiator. In other words, only the items listed by the Initiator will be returned in the result.

*Travel Rule Request Initiator could be Originator VASP or Beneficiary VASP.

In Travel Rule Request Receiver​

Among them, INFO_MISSING and INFO_EXISTS will appear in the information returned by the Receiver. They represent the required information required by the other party's VASP. Regardless of whether the Initiator is included in expectVerifyFields, the results required by the fields will be returned to the Initiator.

*Travel Rule Request Receiver could be Originator VASP or Beneficiary VASP.

You can use the VASP Detail API to query which fields are required by the Receiver, which are presented in the requiredPiiFieldsAsBeneficiary field.

You can also check supportedVerifyFields to check which fields Receiver VASP can help you verify.

See: GET /api/common/v3/vasp/detail

Multiple National Identifications​

IVMS101 carries one nationalIdentification object per person. Identity documents beyond that one are transmitted in specificNationalIdentifications, an object whose keys are a closed set of fixed slots named after the document type — ID_CCPT, ID_IDCD, ID_DRLC, and so on. See About Field - specificNationalIdentifications in the IVMS-101 Format Guidelines for the full structure and filling rules.

Why the documents are not sent as an array​

This page is the reason. A Verify Field is a single numeric ID that has to resolve to exactly one value in the payload, on both sides: the Initiator puts the ID in expectVerifyFields, the Receiver returns a result carrying the same ID, and the exchange only means anything if that ID denotes the same JSON path for both VASPs. The mapping between a Verify Field ID and a JSON path must therefore be one-to-one and fixed before either side writes any code.

An array of identifications breaks that mapping:

  • An array position is not stable. A document's index depends on how many documents happen to sit in front of it, so the same passport is nationalIdentification[1] in one request and nationalIdentification[0] in the next, after an ID card is dropped from the customer's record. A Verify Field ID pinned to index 1 would address a different document every time.
  • Without a stable path the Receiver cannot tell which document the Initiator asked it to verify, and cannot report "passport matched, ID card did not" without ambiguity.
  • Transmitted Content is affected in the same way: its manifest attaches fieldId to a fieldPath, and a shifting array index changes the path of content that never changed.

A fixed slot key removes the moving part. ...specificNationalIdentifications.ID_CCPT.nationalIdentifier is the same path in every payload from every VASP, so each slot can hold a permanently assigned Verify Field ID: one slot ↔ one Verify Field ID ↔ one manifest entry. It is also why the key set is one slot per document type, fully enumerated, with no ordinals — every key in the set has to be assignable to an ID up front.

Slot to Verify Fields ID mapping​

Interim design. Upstream IVMS101 has not yet released a standard way to carry more than one identity document per person, so both the slot structure and these IDs are provisional. If a later edition of IVMS101 publishes an official structure, GTR will follow the standard and notify integrating VASPs to migrate for interoperability. Keep the mapping between your KYC records and the slot keys in one place so that a change stays cheap.

Each ID addresses the nationalIdentifier value inside that slot. The document type needs no separate ID, because the slot key already fixes it.

Every slot has a distinct Verify Fields ID per direction and per entity type, so a single ID always resolves to exactly one JSON path. The full definition of each ID is in the PII Verify Fields Reference Table below.

Slot Key

nationalIdentifierType

Originator - Natural Person

Originator - Legal Person

Beneficiary - Natural Person

ID_ISO20022

ISO20022

100060

101049

110060

ID_ARNU

ARNU

100061

101050

110061

ID_CCPT

CCPT

100062

101051

110062

ID_RAID

RAID

100063

101052

110063

ID_DRLC

DRLC

100064

101053

110064

ID_FIIN

FIIN

100065

101054

110065

ID_TXID

TXID

100066

101055

110066

ID_SOCS

SOCS

100067

101056

110067

ID_IDCD

IDCD

100068

101057

110068

ID_LEIX

LEIX

100069

101058

110069

ID_MISC

MISC

100070

101059

110070

ID_RAID and ID_LEIX are for legal persons. IVMS101 defines RAID as body-corporate only and LEIX as legal-entity only. The Natural Person IDs on those two rows (100063, 110063, 100069, 110069) exist in the global definition for completeness; do not fill those slots on a naturalPerson.

The optional dateOfIssue and dateOfExpiry extension fields inside a slot have no Verify Fields ID assigned. They are transmitted with the slot, but they cannot be listed in expectVerifyFields and no verification result is returned for them.

Notes:

  • Slots are defined for the Originator and Beneficiary persons only. The OriginatingVASP and BeneficiaryVASP entities keep using their existing single-identification fields (121002/121003, 131002/131003).
  • The existing nationalIdentification fields (100044/100045, 110044/110045, and the Legal Person equivalents) are unchanged and keep addressing the IVMS101 nationalIdentification object.
  • A slot that the sender did not fill is absent from the payload. Requesting its ID returns the same result as any other absent field: REQUIRED_INFO_MISSING when the Receiver requires it, otherwise the Receiver's usual unverifiable status.

PII Verify Fields Reference Table​

Update: 2026 Oct 02

VerifyFields

IVMS Name

Direction

Entity Type

Verify Rules ID

121001

Legal Person Name

OriginatingVASP

Legal Person

121001

Legal Person Name

OriginatingVASP

Legal Person

121002

Legal Person National Identifier ID Type

OriginatingVASP

Legal Person

121003

Legal Person National Identifier ID

OriginatingVASP

Legal Person

121004

Legal Person National Identifier Registration Authority ID

OriginatingVASP

Legal Person

121005

Legal Person National Identifier Country of Issue

121007

Legal Person Address - Country

OriginatingVASP

Legal Person

121008

Legal Person Address - Town Name

OriginatingVASP

Legal Person

121009

Legal Person Address - Address Lines

OriginatingVASP

Legal Person

121010

Legal Person Address - Department

OriginatingVASP

Legal Person

121011

Legal Person Address - Sub Department

OriginatingVASP

Legal Person

121012

Legal Person Address - Street

OriginatingVASP

Legal Person

121013

Legal Person Address - Building Number

OriginatingVASP

Legal Person

121014

Legal Person Address - Building Name

OriginatingVASP

Legal Person

121015

Legal Person Address - Floor

OriginatingVASP

Legal Person

121016

Legal Person Address - Postbox

OriginatingVASP

Legal Person

121017

Legal Person Address - Room

OriginatingVASP

Legal Person

121018

Legal Person Address - Post Code

OriginatingVASP

Legal Person

121019

Legal Person Address - Town Location

OriginatingVASP

Legal Person

121020

Legal Person Address - District Name

OriginatingVASP

Legal Person

121021

Legal Person Address - Country of Sub Division

OriginatingVASP

Legal Person

121022

Legal Person Country of Registration

OriginatingVASP

Legal Person

131001

Legal Person Name

BeneficiaryVASP

Legal Person

131002

Legal Person National Identifier ID Type

BeneficiaryVASP

Legal Person

131003

Legal Person National Identifier ID

BeneficiaryVASP

Legal Person

131004

Legal Person National Identifier Registration Authority ID

BeneficiaryVASP

Legal Person

131005

Legal Person National Identifier Country of Issue

BeneficiaryVASP

Legal Person

131007

Legal Person Address - Country

BeneficiaryVASP

Legal Person

131008

Legal Person Address - Town Name

BeneficiaryVASP

Legal Person

131009

Legal Person Address - Address Lines

BeneficiaryVASP

Legal Person

131010

Legal Person Address - Department

BeneficiaryVASP

Legal Person

131011

Legal Person Address - Sub Department

BeneficiaryVASP

Legal Person

131012

Legal Person Address - Street

BeneficiaryVASP

Legal Person

131013

Legal Person Address - Building Number

BeneficiaryVASP

Legal Person

131014

Legal Person Address - Building Name

BeneficiaryVASP

Legal Person

131015

Legal Person Address - Floor

BeneficiaryVASP

Legal Person

131016

Legal Person Address - Postbox

BeneficiaryVASP

Legal Person

131017

Legal Person Address - Room

BeneficiaryVASP

Legal Person

131018

Legal Person Address - Post Code

BeneficiaryVASP

Legal Person

131019

Legal Person Address - Town Location

BeneficiaryVASP

Legal Person

131020

Legal Person Address - District Name

BeneficiaryVASP

Legal Person

131021

Legal Person Address - Country of Sub Division

BeneficiaryVASP

Legal Person

131022

Legal Person Country of Registration

BeneficiaryVASP

Legal Person

101001

Legal Person Name

Originator

Legal Person

101002

Legal Person National Identifier ID Type

Originator

Legal Person

101003

Legal Person National Identifier ID

Originator

Legal Person

101004

Legal Person National Identifier Registration Authority ID

Originator

Legal Person

101005

Legal Person National Identifier Country of Issue

Originator

Legal Person

101006

Legal Person Customer Identification

Originator

Legal Person

101007

Legal Person Address - Country

Originator

Legal Person

101008

Legal Person Address - Town Name

Originator

Legal Person

101009

Legal Person Address - Address Lines

Originator

Legal Person

101010

Legal Person Address - Department

Originator

Legal Person

101011

Legal Person Address - Sub Department

Originator

Legal Person

101012

Legal Person Address - Street

Originator

Legal Person

101013

Legal Person Address - Building Number

Originator

Legal Person

101014

Legal Person Address - Building Name

Originator

Legal Person

101015

Legal Person Address - Floor

Originator

Legal Person

101016

Legal Person Address - Postbox

Originator

Legal Person

101017

Legal Person Address - Room

Originator

Legal Person

101018

Legal Person Address - Post Code

Originator

Legal Person

101019

Legal Person Address - Town Location

Originator

Legal Person

101020

Legal Person Address - District Name

Originator

Legal Person

101021

Legal Person Address - Country of Sub Division

Originator

Legal Person

101022

Legal Person Country of Registration

Originator

Legal Person

101049

Legal Person National ID - ISO20022

Originator

Legal Person

101050

Legal Person National ID - Alien registration number

Originator

Legal Person

101051

Legal Person National ID - passport number

Originator

Legal Person

101052

Legal Person National ID - Business registration number provided by the authority

Originator

Legal Person

101053

Legal Person National ID - Driver's License Number

Originator

Legal Person

101054

Legal Person National ID - Foreign Investor Number

Originator

Legal Person

101055

Legal Person National ID - Number given by the tax authority

Originator

Legal Person

101056

Legal Person National ID - Social Security Number or National Identification Number

Originator

Legal Person

101057

Legal Person National ID - Identity card number assigned by a state agency

Originator

Legal Person

101058

Legal Person National ID - Global legal entity identification number

Originator

Legal Person

101059

Legal Person National ID - ID card number from other countries

Originator

Legal Person

103023

Account Number

Originator

Others

100024

Natural Person Place of Birth

Originator

Natural Person

100025

Natural Person Date of Birth

Originator

Natural Person

100026

Natural Person Name

Originator

Natural Person

100027

Natural Person Local Name

Originator

Natural Person

100028

Natural Person Phonetic Name

Originator

Natural Person

100029

Natural Person Address - Country

Originator

Natural Person

100030

Natural Person Address - Town Name

Originator

Natural Person

100031

Natural Person Address - Address Lines

Originator

Natural Person

100032

Natural Person Address - Department

Originator

Natural Person

100033

Natural Person Address - Sub Department

Originator

Natural Person

100034

Natural Person Address - Street

Originator

Natural Person

100035

Natural Person Address - Building Number

Originator

Natural Person

100036

Natural Person Address - Building Name

Originator

Natural Person

100037

Natural Person Address - Floor

Originator

Natural Person

100038

Natural Person Address - Postbox

Originator

Natural Person

100039

Natural Person Address - Room

Originator

Natural Person

100040

Natural Person Address - Post Code

Originator

Natural Person

100041

Natural Person Address - Town Location

Originator

Natural Person

100042

Natural Person Address - District Name

Originator

Natural Person

100043

Natural Person Address - Country of Sub Division

Originator

Natural Person

100044

Natural Person National ID - Type

Originator

Natural Person

100045

Natural Person National ID

Originator

Natural Person

100046

Natural Person National ID - Country Of Issue

Originator

Natural Person

100047

Natural Person Customer ID

Originator

Natural Person

100048

Natural Person Country of Residence

Originator

Natural Person

100060

Natural Person National ID - ISO20022

Originator

Natural Person

100061

Natural Person National ID - Alien registration number

Originator

Natural Person

100062

Natural Person National ID - passport number

Originator

Natural Person

100063

Natural Person National ID - Business registration number provided by the authority

Originator

Natural Person

100064

Natural Person National ID - Driver's License Number

Originator

Natural Person

100065

Natural Person National ID - Foreign Investor Number

Originator

Natural Person

100066

Natural Person National ID - Number given by the tax authority

Originator

Natural Person

100067

Natural Person National ID - Social Security Number or National Identification Number

Originator

Natural Person

100068

Natural Person National ID - Identity card number assigned by a state agency

Originator

Natural Person

100069

Natural Person National ID - Global legal entity identification number

Originator

Natural Person

100070

Natural Person National ID - ID card number from other countries

Originator

Natural Person

111001

Legal Person Name

Beneficiary

Legal Person

111002

Legal Person National Identifier ID Type

Beneficiary

Legal Person

111003

Legal Person National Identifier ID

Beneficiary

Legal Person

111004

Legal Person National Identifier Registration Authority ID

Beneficiary

Legal Person

111005

Legal Person National Identifier Country of Issue

Beneficiary

Legal Person

111006

Legal Person Customer Identification

Beneficiary

Legal Person

111007

Legal Person Address - Country

Beneficiary

Legal Person

111008

Legal Person Address - Town Name

Beneficiary

Legal Person

111009

Legal Person Address - Address Lines

Beneficiary

Legal Person

111010

Legal Person Address - Department

Beneficiary

Legal Person

111011

Legal Person Address - Sub Department

Beneficiary

Legal Person

111012

Legal Person Address - Street

Beneficiary

Legal Person

111013

Legal Person Address - Building Number

Beneficiary

Legal Person

111014

Legal Person Address - Building Name

Beneficiary

Legal Person

111015

Legal Person Address - Floor

Beneficiary

Legal Person

111016

Legal Person Address - Postbox

Beneficiary

Legal Person

111017

Legal Person Address - Room

Beneficiary

Legal Person

111018

Legal Person Address - Post Code

Beneficiary

Legal Person

111019

Legal Person Address - Town Location

Beneficiary

Legal Person

111020

Legal Person Address - District Name

Beneficiary

Legal Person

111021

Legal Person Address - Country of Sub Division

Beneficiary

Legal Person

111022

Legal Person Country of Registration

Beneficiary

Legal Person

111049

Legal Person National ID - ISO20022

Beneficiary

Legal Person

111050

Legal Person National ID - Alien registration number

Beneficiary

Legal Person

111051

Legal Person National ID - passport number

Beneficiary

Legal Person

111052

Legal Person National ID - Business registration number provided by the authority

Beneficiary

Legal Person

111053

Legal Person National ID - Driver's License Number

Beneficiary

Legal Person

111054

Legal Person National ID - Foreign Investor Number

Beneficiary

Legal Person

111055

Legal Person National ID - Number given by the tax authority

Beneficiary

Legal Person

111056

Legal Person National ID - Social Security Number or National Identification Number

Beneficiary

Legal Person

111057

Legal Person National ID - Identity card number assigned by a state agency

Beneficiary

Legal Person

111058

Legal Person National ID - Global legal entity identification number

Beneficiary

Legal Person

111059

Legal Person National ID - ID card number from other countries

Beneficiary

Legal Person

113023

Account Number

Beneficiary

Others

110024

Natural Person Place of Birth

Beneficiary

Natural Person

110025

Natural Person Date of Birth

Beneficiary

Natural Person

110026

Natural Person Name

Beneficiary

Natural Person

110027

Natural Person Local Name

Beneficiary

Natural Person

110028

Natural Person Phonetic Name

Beneficiary

Natural Person

110029

Natural Person Address - Country

Beneficiary

Natural Person

110030

Natural Person Address - Town Name

Beneficiary

Natural Person

110031

Natural Person Address - Address Lines

Beneficiary

Natural Person

110032

Natural Person Address - Department

Beneficiary

Natural Person

110033

Natural Person Address - Sub Department

Beneficiary

Natural Person

110034

Natural Person Address - Street

Beneficiary

Natural Person

110035

Natural Person Address - Building Number

Beneficiary

Natural Person

110036

Natural Person Address - Building Name

Beneficiary

Natural Person

110037

Natural Person Address - Floor

Beneficiary

Natural Person

110038

Natural Person Address - Postbox

Beneficiary

Natural Person

110039

Natural Person Address - Room

Beneficiary

Natural Person

110040

Natural Person Address - Post Code

Beneficiary

Natural Person

110041

Natural Person Address - Town Location

Beneficiary

Natural Person

110042

Natural Person Address - District Name

Beneficiary

Natural Person

110043

Natural Person Address - Country of Sub Division

Beneficiary

Natural Person

110044

Natural Person National ID - Type

Beneficiary

Natural Person

110045

Natural Person National ID

Beneficiary

Natural Person

110046

Natural Person National ID - Country Of Issue

Beneficiary

Natural Person

110047

Natural Person Customer ID

Beneficiary

Natural Person

110048

Natural Person Country of Residence

Beneficiary

Natural Person

110060

Natural Person National ID - ISO20022

Beneficiary

Natural Person

110061

Natural Person National ID - Alien registration number

Beneficiary

Natural Person

110062

Natural Person National ID - passport number

Beneficiary

Natural Person

110063

Natural Person National ID - Business registration number provided by the authority

Beneficiary

Natural Person

110064

Natural Person National ID - Driver's License Number

Beneficiary

Natural Person

110065

Natural Person National ID - Foreign Investor Number

Beneficiary

Natural Person

110066

Natural Person National ID - Number given by the tax authority

Beneficiary

Natural Person

110067

Natural Person National ID - Social Security Number or National Identification Number

Beneficiary

Natural Person

110068

Natural Person National ID - Identity card number assigned by a state agency

Beneficiary

Natural Person

110069

Natural Person National ID - Global legal entity identification number

Beneficiary

Natural Person

110070

Natural Person National ID - ID card number from other countries

Beneficiary

Natural Person

ISO20022 Document Example​

Verify Fields 100060 and 110060 carry an ISO20022 document as the identifier value. The format is a pacs.008 message:

<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pacs.008.001.08">
<FIToFICstmrCdtTrf>
<!-- 1. Message Header Group (GrpHdr) -->
<GrpHdr>
<MsgId>MSG20261002-99812</MsgId>
<CreDtTm>2026-10-02T13:55:00Z</CreDtTm>
<NbOfTxs>1</NbOfTxs>
</GrpHdr>

<!-- 2. Core Transaction Details (CdtTrfTxInf) -->
<CdtTrfTxInf>
<PmtId>
<EndToEndId>E2E-987654321</EndToEndId>
</PmtId>

<!-- Amount and Currency ($5,000.00 USD) -->
<IntrBkSttlmAmt Ccy="USD">5000.00</IntrBkSttlmAmt>

<!-- 3. Debtor / Sender Info (Dbtr) -->
<Dbtr>
<Nm>John Doe</Nm>
<PstlAdr>
<StrtNm>Orchard Road</StrtNm>
<BldgNb>123</BldgNb>
<Ctry>SG</Ctry>
</PstlAdr>
</Dbtr>

<!-- Sender's Bank (DbtrAgt) using SWIFT Code (BIC) -->
<DbtrAgt>
<FinInstnId>
<BICFI>DBSSSGSGXxx</BICFI>
</FinInstnId>
</DbtrAgt>

<!-- 4. Creditor's Bank / Receiver's Bank (CdtrAgt) -->
<CdtrAgt>
<FinInstnId>
<BICFI>CHYBUS33Xxx</BICFI>
</FinInstnId>
</CdtrAgt>

<!-- 5. Creditor / Receiver Info (Cdtr) -->
<Cdtr>
<Nm>Alice Smith</Nm>
<PstlAdr>
<StrtNm>Fifth Avenue</StrtNm>
<BldgNb>456</BldgNb>
<Ctry>US</Ctry>
</PstlAdr>
</Cdtr>
</CdtTrfTxInf>
</FIToFICstmrCdtTrf>
</Document>