Verification Result List

Get verification result list

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

You can get the list of past verification requests and results using this API.

In querying the verification history, you can use multiple optional query parameters collaboratively(AND operation) to specify the targets.

Request

Query Parameters

Field Name	Data Type	Required	Example	Description
fromDate	string	false	“2022-01-01”	Starting datetime for verification request time duration to query. (Default : 1970-01-01)
toDate	string	false	"2011-01-15”	Ending datetime for verification request time duration to query. (Default: datetime of API executed)
symbol	string	false	"ETH”	A symbol of the virtual asset
network	string	false	"Ethereum"	The blockchain network of virtual asset
txHash	string	false	“0x9fd7bfd46e4402c7197b4d8deb0199fcf7c1f57ef70c339f403a1cb060c31c28”	Transaction ID (Transaction hash, txHash).
result	string	false	“VERIFIED”	Verification result
actionType	string	false	“SEND”	VASP Transaction Type.
oppositeVaspId	string	false	“27372039731940175”	ID of VASP that is the opposite side of verification to query.
originatorAccountNumber	string	false	“0x5811001506550d8356a215be229c15b6ef371a9a”	Originator's wallet address
beneficiaryAccountNumber	string	false	“0x5811001506550d8356a215be229c15b6ef371a9b”	Beneficiary's wallet address.
page	number	false	1	Paging number (default : 1)
rpp	number	false	10	Number of records to fetch (default : 10)

• 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.

• actionType field specification is as follows.

  • The field value is one of "SEND" or "RECEIVE" along with the VASP Transaction Type.

  • SEND: VASP sending case.

  • RECEIVE: VASP receiving case.

Response Body

Payload

Field Name	Data Type	Required	Example	Description
count	number	true	172	Total number of verification results
page	number	true	1	Paging number (default : 1)
rpp	number	true	10	Number of records in this list (default : 10)
verifications	array	true	-	Verification result list
verifications.verificationId	string	true	"12345"	Verification result ID
verifications.verificationUuid	string	true	"4615aa9d-ac64-4997-a9e6-0e772c57c7ef"	Verification request ID
verifications.result	string	false	"VERIFIED"	Verification result code
verifications.reason	string	false	"OK"	Error code in case of verification failure, OK in case of success.
verifications.assetInfo	object	true	-	Virtual asset description object
verifications.assetInfo.symbol	string	true	“ETH”	A symbol of virtual asset
verifications.assetInfo.network	string	false	"Ethereum"	The blockchain network of virtual asset
verifications.assetInfo.amount	string	true	“0.024”	Amount of asset to transfer
verifications.assetInfo.isExceedingThreshold	boolean	true	true	Whether the amount is over the legal threshold in fiat currency conversion of virtual assets to be transferred
verifications.assetInfo.tradePrice	string	true	“2439800”	The amount of virtual assets to be transferred converted to fiat currency
verifications.assetInfo.tradeCurrency	string	true	“KRW”	A symbol of fiat currency
verifications.assetInfo.tradeISODatetime	string	true	“2022-02-06T23:13:43.513Z”	Application time of currency conversion price to fiat money in ISO format
verifications.txHash	string	true	“0x9fd7bfd46e4402c7197b4d8deb0199fcf7c1f57ef70c339f403a1cb060c31c28”	Transaction ID (Transaction hash, txHash).
verifications.vout	string	false	"2"	An index value indicating which transfer corresponds to within a single transaction
verifications.originatingVaspId	string	true	"15952089931162058999"	Originating VASP ID
verifications.originatorAccountNumber	string	true	[”0x001506550d8356a215be229c15b6ef371a9a”]	Originator's wallet address
verifications.ivms101Originator	string	true	"{'originatorPersons':[{'naturalPerson':{'name':{'nameIdentifier':[{'primaryIdentifier':'Taylor','nameIdentifierType':'LEGL'}]},'accountNumber':['1G3qCGKP5dQtQ7secCPTCDPU9Wfjp9x3Hb']}"	IVMS101 format of originator information
verifications.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
verifications.beneficiaryVaspId	string	true	"15952089931162058777"	Beneficiary VASP ID
verifications.beneficiaryAccountNumber	string	true	[”0x001506550d8356a215be229c15b6ef371a9b”]	Beneficiary account number
verifications.ivms101Beneficiary	string	true	"{'originatorPersons':[{'naturalPerson':{'name':{'nameIdentifier':[{'primaryIdentifier':'James','nameIdentifierType':'LEGL'}]},'accountNumber':['1G3qCGKP5dQtQ7secCPTCDPU9Wfjp9x3Hb']}"	IVMS101 format of Beneficiary information
verifications.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
verifications.verifiedAt	string	true	"2022-02-22T14:41:50.000Z"	Verification datetime
verifications.orderedAt	Date	true	"2022-02-22T14:42:12.000Z"	Transaction ID reporting datetime
verifications.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.

  • 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 by 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

• verifications.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.