User KYC information query

Interface Description

Query the KYC information that the user has completed

Interface endpoint：

POST:https://api.chaintool.ai/kyc/v1/querykyc

Request Parameters

Parameter	Required	Description
kycId	Yes	The kycId obtained from the OCR interface in the current kyc process

Response Parameters

Parameter	Required	Description
kycStatus	Yes	kyc status of the current user, representing Success or Failure
kycId	Yes	kycId for the current user
expireTime	Yes	expiration time（Measured in milliseconds）
face	Yes	Bio (face) information object for the current user
face.faceRecognitionPhotoUrl	Yes	User identified face information photo data
face.compareStatus	Yes	Whether the comparison is successful,Success or Failed
face.faceRecognitionStatus	Yes	Whether the face recognition is successful
face.compareResultExpireTime	Yes	Expiration time of face comparison results（timestamp）
face.faceExpireTime	Yes	Expiration time of face information(timestamp)
face.compareResult	Yes	Whether the compare result valid or not
document	Yes	The user's document information object
document.country	Yes	Country
document.firstName	Yes
document.lastName	No
document.gender	No
document.documentType	Yes
document.idNumber	Yes
document.valid	Yes
document.dateOfBirth	Yes
document.expireTime	No
document.documentFrontPhotoUrl	Yes	Url of front photo of document
document.documentBackPhotoUrl	Yes	Url of back photo of document

Request Example

{
    "kycId":"24156127721166358"
}

Response Example

{
    "face":{
        "faceRecognitionPhotoUrl":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCAKAAeADASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcRMiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX8JRDLrj2cs0bvHLH5sVc8xzmf//Z",
        "compareStatus":"Success",
        "faceRecognitionStatus":"Success",
        "compareResultExpireTime":1720540800000,
        "faceExpireTime":1720540800000,
        "compareResult":true
    },
    "expireTime":2104761600000,
    "kycStatus":"Success",
    "document":{
        "country":"China",
        "lastName":"刘德华",
        "gender":"M",
        "documentType":"IDENTITY_CARD_CHINA",
        "documentBackPhotoUrl":"/9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1BST0ZJTEUAAQEAAAHIAAAAAAQwAABtbnRyUkdCIFhZWiAH4AABAAEAAAAAAABhY3NwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAA9tYAAQAAAADTLQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAlkZXNjAAAA8AAAACRyWFlaAAABFAAAABRnWFlaAAABKAAAABRiWFlaAAABPAAAABR3dHB0AAABUAAAABRyVFJDAAABZAAAAChnVFJDAAABZAAAAChiVFJDAAABZAAAAChjcHJ0AAABjAAAADxtbHVjAAAAAAAAAAEAAAAMZW5VUwAAAAgAAAAcAHMAUgBHAEJYWVogAAAAAAAAb6IAADj1AAADkFhZWiAAAAAAAABimQAAt4UAABjaWFlaIAAAAAAAACSgAAAPhAAAts9YWVogAAAAAAAA9tYAAQAAAADTLXBhcmEAAAAAAAe97qG5xP8PuflUyB/RJJIJKBO45Qv8A9aEklRM0CDj3QHMz7pJIJYEDCJgG44SSRgb2gCQByjaBuP0SSV+AY+7P/ngI29wkko1B9nKM90kkVI4ANwE/cJJIB/w/ijSSQWD90J+XGfZJJAxAnjuic1rY2gCfb6JJIBgHspWAeW7HskkjUG0CRgKUAeUDHskkjNCOAFI3DxCSSRYdmSfr/micT9pInASSRpZ5AlO4CRjskkjN7C7BbCtUADTMhJJD5BV+6jIHkkx3SSSNP//Z",
        "dateOfBirth":"1987-06-01 00:00:00",
        "idNumber":"321321321321321321321",
        "valid":true,
        "firstName":"刘德华",
        "expireTime":"2036-09-12 00:00:00",
        "documentFrontPhotoUrl":"/9j/4AAUSkZJRgABAQEBLAEsAABBTVBG/+EKkEV4aWYAAE1NACoAAAAIAAwBDwACAAAABgAAAJ4BEAACAAAACgAAAKQBEgADAAAAAQABAAABGgAFAAAAAQAAAK4BGwAFAAAAAQAAALYBKAADAAAAAQACAAABMQACAAAABwAAAL4BMgACAAAAFAAAAMYBPAACAAAACgAAANoCEwADAAAAAQABAACHaQAEAAAAAQAAAOSIJQAEAAAAAQAACYwAAAAAQXBwbGUAaVBob25lIDEzAAAAAEgAAAABAAAASAAAAAExNS40LjELqSiiiq9Sf8ALOpKj8uo6k3+1SVXooqxVerFV6k8uo6KsUVXqxVeiiiiiiiiiiiiiiiiiiiq9SeXUlf/2Q==",
        "status":"Success"
    },
    "errorCode":200,
    "kycId":"24156127721166358",
    "message":"SUCCESS"
}