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

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"
}

PreviousVerification Result List NextTransaction Result Report

Last updated 1 year ago