VerifyVASP
Search
K
Comment on page

Verification Result by UUID

get
http://<enclave-endpoint>
/v1/verifications/:UUID
Get verification result by 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": {
"symbol": "BTC",
"amount": "100123",
"isExceedingThreshold": 1,
"tradeCurrency": "123",
"tradePrice": "100",
"tradeISODatetime": "2022-02-02T10:00:00.000Z"
},
"txHash": null,
"originatingVaspId": "15952089931162058999",
"originatorAccountNumber": "0xtest001506550d8356a215be229c15b6ef371a9a",
"ivms101Originator": "{\"originatorPersons\":[{\"naturalPerson\":{\"name\":{\"nameIdentifier\":[{\"primaryIdentifier\":\"Taylor\",\"nameIdentifierType\":\"LEGL\"}]},\"geographicAddress\":[{\"addressType\":\"test\",\"buildingName\":\"123\",\"townName\":\"Yeoksam-dong\",\"country\":\"KR\"}]}}]}",
"ivms101OriginatingVasp": "{\"legalPerson\":{\"name\":{\"nameIdentifier\":[{\"legalPersonName\":\"perftest1\",\"legalPersonNameIdentifierType\":\"LEGL\"}]},\"geographicAddress\":[{\"addressType\":\"GEOG\",\"postcode\":\"13525\",\"townName\":\"Yeoksam-dong\",\"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.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).
originatingVaspId
string
true
"15952089931162058999"
Originating VASP ID
originatorAccountNumber
string
true
[”0xtest001506550d8356a215be229c15b6ef371a9a”]
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':'Yeoksam-dong','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
[”0xtest001506550d8356a215be229c15b6ef371a9b”]
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':'Yeoksam-dong','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-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 probloems in sanction screening
    UNVERIFIED-KYC
    DENIED
    -
    User KYC required
    MISMATCHED-NAME
    DENIED
    -
    Name mismatch
    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"
}