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
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
Last updated