Verification Result by UUID

Get verification result by UUID

GET http://<enclave-endpoint>/v1/verifications/:UUID

You can get a single result of verification with UUID.

Response Body

Success case

Response Body Examples

• 200 OK

{
  "verificationId": "10",
  "verificationUuid": "5c9f6f44-1e09-483b-a9f5-5950b1cbae08",
  "result": "VERIFIED",
  "reason": "OK",
  "message": "",
  "assetInfo": {
    "network": "Bitcoin",
    "symbol": "BTC",
    "amount": "100123",
    "isExceedingThreshold": 1,
    "tradeCurrency": "123",
    "tradePrice": "100",
    "tradeISODatetime": "2022-02-02T10:00:00.000Z"
  },
  "txHash": null,
  "vout": null,
  "originatingVaspId": "15952089931162058999",
  "originatorAccountNumber": "0x001506550d8356a215be229c15b6ef371a9a",
  "ivms101Originator": "{\"originatorPersons\":[{\"naturalPerson\":{\"name\":{\"nameIdentifier\":[{\"primaryIdentifier\":\"Taylor\",\"nameIdentifierType\":\"LEGL\"}]},\"geographicAddress\":[{\"addressType\":\"test\",\"buildingName\":\"123\",\"townName\":\"test\",\"country\":\"KR\"}]}}]}",
  "ivms101OriginatingVasp": "{\"legalPerson\":{\"name\":{\"nameIdentifier\":[{\"legalPersonName\":\"perftest1\",\"legalPersonNameIdentifierType\":\"LEGL\"}]},\"geographicAddress\":[{\"addressType\":\"GEOG\",\"postcode\":\"13525\",\"townName\":\"Seoul City\",\"addressLine\":[\"Gangnam-gu, Gangbuck-do\",\"abc\"],\"country\":\"AF\"}],\"nationalIdentification\":{\"nationalIdentifier\":\"983746561\",\"nationalIdentifierType\":\"RAID\",\"registrationAuthority\":\"RA000025\"}}}",
  "beneficiaryVaspId": "15952089931162059995",
  "beneficiaryAccountNumber": "1G3qCGKP5dQtQ7secCPTCDPU9Wfjp9x3Hb",
  "ivms101Beneficiary": "{\"beneficiaryPersons\":[{\"naturalPerson\":{\"name\":{\"nameIdentifier\":[{\"primaryIdentifier\":\"Taylor\",\"secondaryIdentifier\":\"Robbins\",\"nameIdentifierType\":\"LEGL\"}]}}}],\"accountNumber\":[\"1G3qCGKP5dQtQ7secCPTCDPU9Wfjp9x3Hb\"]}",
  "ivms101BeneficiaryVasp": "{\"legalPerson\":{\"name\":{\"nameIdentifier\":[{\"legalPersonName\":\"perftest2\",\"legalPersonNameIdentifierType\":\"LEGL\"}]},\"geographicAddress\":[{\"addressType\":\"GEOG\",\"postcode\":\"13525\",\"townName\":\"Yeoksam-dong\",\"addressLine\":[\"14, Teheran-ro 4-gil\",\"Gangnam-gu\"],\"country\":\"AF\"}],\"nationalIdentification\":{\"nationalIdentifier\":\"7612873123\",\"nationalIdentifierType\":\"RAID\",\"registrationAuthority\":\"RA000073\"}}}",
  "verifiedAt": "2022-02-22T05:12:41.000Z",
  "orderedAt": null,
  "createdAt": "2022-02-22T05:12:40.000Z"
}

Field Name	Data Type	Required	Example	Description
verificationUuid	string	true	"4615aa9d-ac64-4997-a9e6-0e772c57c7ef"	Verification request ID
result	string	false	"VERIFIED"	Verification result code
reason	string	false	"OK"	Error code in case of verification failure, OK in case of success.
assetInfo	object	true	-	Virtual asset description object
assetInfo.symbol	string	true	“ETH”	A symbol of virtual asset
assetInfo.network	string	false	"Ethereum"	The blockchain network of virtual asset
assetInfo.amount	string	true	“0.024”	Amount of asset to transfer
assetInfo.isExceedingThreshold	boolean	true	true	Whether the amount is over the legal threshold in fiat currency conversion of virtual assets to be transferred
assetInfo.tradePrice	string	true	“2439800”	The amount of virtual assets to be transferred converted to fiat currency
assetInfo.tradeCurrency	string	true	“KRW”	A symbol of fiat currency
assetInfo.tradeISODatetime	string	true	“2022-02-06T23:13:43.513Z”	Application time of currency conversion price to fiat money in ISO format
txHash	string	true	“0x9fd7bfd46e4402c7197b4d8deb0199fcf7c1f57ef70c339f403a1cb060c31c28”	Transaction ID (Transaction hash, txHash).
vout	string	false	"2"	An index value indicating which transfer corresponds to within a single transaction
originatingVaspId	string	true	"15952089931162058999"	Originating VASP ID
originatorAccountNumber	string	true	[”0x001506550d8356a215be229c15b6ef371a9a”]	Originator's wallet address
ivms101Originator	string	true	"{'originatorPersons':[{'naturalPerson':{'name':{'nameIdentifier':[{'primaryIdentifier':'Taylor','nameIdentifierType':'LEGL'}]},'accountNumber':['1G3qCGKP5dQtQ7secCPTCDPU9Wfjp9x3Hb']}"	IVMS101 format of originator information
ivms101OriginatingVasp	string	true	"{'legalPerson':{'name':{'nameIdentifier':[{'legalPersonName':'A Exchange','legalPersonNameIdentifierType':'LEGL'}]},'geographicAddress':[{'addressType':'GEOG','postcode':'12345','townName':'Seoul City','addressLine':['Gangnam-gu, Gangbuck-do'],'country':'KR'}],'nationalIdentification':{'nationalIdentifier':'KR001','nationalIdentifierType':'RAID','registrationAuthority':'RA001'}}}"	IVMS101 format of originating VASP information
beneficiaryVaspId	string	true	"15952089931162058777"	Beneficiary VASP ID
beneficiaryAccountNumber	string	true	[”0x001506550d8356a215be229c15b6ef371a9b”]	Beneficiary account number
ivms101Beneficiary	string	true	"{'originatorPersons':[{'naturalPerson':{'name':{'nameIdentifier':[{'primaryIdentifier':'James','nameIdentifierType':'LEGL'}]},'accountNumber':['1G3qCGKP5dQtQ7secCPTCDPU9Wfjp9x3Hb']}"	IVMS101 format of Beneficiary information
ivms101BeneficiaryVasp	string	true	"{'legalPerson':{'name':{'nameIdentifier':[{'legalPersonName':'B Exchange','legalPersonNameIdentifierType':'LEGL'}]},'geographicAddress':[{'addressType':'GEOG','postcode':'12345','townName':'Seoul City','addressLine':['Gangnam-gu, Gangbuck-do'],'country':'KR'}],'nationalIdentification':{'nationalIdentifier':'KR002','nationalIdentifierType':'RAID','registrationAuthority':'RA001'}}}"	IVMS101 format of Beneficiary VASP information
verifiedAt	string	true	"2022-02-22T14:41:50.000Z"	Verification datetime
orderedAt	Date	true	"2022-02-22T14:42:12.000Z"	Transaction ID reporting datetime
createdAt	Date	true	"2022-02-22T14:41:49.000Z"	Verification request datetime

• result field specification is as follows.

  • The field value is one of "VERIFIED","DENIED","UNKNOWN","ERROR"

  • VERIFIED: The user is successfully verified without any doubt or problem.

  • DENIED: The wallet address is valid but the requested action is not allowed from the user's unexpected problems. (e.g. lack of KYC credential)

  • UNKNOWN: The wallet address is unknown to the VASP.

  • ERROR: Any other exceptional cases.

• reason field specification is as follows.

  • The field is valid only when result the field is DENIED.

  • Refer to the below table for the message field value.

  reason (string)	result (string)	message (string)	Description
  UNKNOWN-SYMBOL	DENIED	The value of symbol name (which is not supported in VASP)	Unknown or not supported asset symbol
  UNKNOWN-NETWORK	DENIED	The value of network name (which is not supported in VASP)	Unknown or not supported blockchain network (i.e. symbol matches but network does not)
  UNKNOWN-ADDRESS	DENIED	The unknown wallet address	Unknown wallet address to the VASP
  LACK-OF-INFORMATION	DENIED	A comma(,) separated required but missing personal information fields list	Verification denied due to lack of personal information
  UNAVAILABLE-INFORMATION	DENIED	A comma(,) separated undeliverable personal information field list	Requested personal information cannot be transferred for processing
  BLACKLISTED	DENIED	-	Verification denied having problems in sanction screening
  UNVERIFIED-KYC	DENIED	-	User KYC required
  MISMATCHED-NAME	DENIED	-	Name mismatch
  NOT-ALLOWED	DENIED	The reason why it is not allowed	The originating VASP reject the user's withdrawal request for any reason.
  UNDEFINED-ERROR	DENIED	Error description	Unexpected exceptional case happens
  BENEFICIARY-ACCOUNT-NOT-MATCHED	ERROR	-	Beneficiary address is mismatched by VASP
  REQUEST-TIMEOUT	ERROR	-	Verification processing exceeds the timeout limit

• assetInfo.isExceedingThreshold field specification

  • If the amount of virtual asset transfer is over or equal to the legal threshold for verification requirement, use true.

  • Or, the field returns false.

Error Codes

The input of non-existing verification UUID

Response Body Examples

• 404 Not Found

{
  "code": "VERIFICATION-NOT-FOUND",
  "message": "Verification(9faab87c-54a6-4145-baa9-7a3a42d7410c) is not found"
}