After the Verification process is done on the user side, you can request the result by calling the Get Result API.

Request Example:

curl -X POST \
  https://ph-api.advance.ai/intl/openapi/identity-risk/idvs-h5/ekyc/v1/get-result \
  -H 'Content-Type: application/json' \
  -H 'X-ACCESS-TOKEN:{Your Access Token}' \
  -d '{"signatureId": "f302f5d2454a85c2"}'

Request Url

https://api.advance.ai/intl/openapi/identity-risk/idvs-h5/ekyc/v1/get-result
POST (application/json)

https://sg-api.advance.ai/intl/openapi/identity-risk/idvs-h5/ekyc/v1/get-result
POST (application/json)

https://ph-api.advance.ai/intl/openapi/identity-risk/idvs-h5/ekyc/v1/get-result
POST (application/json)

https://th-api.advance.ai/intl/openapi/identity-risk/idvs-h5/ekyc/v1/get-result
POST (application/json)

https://my-api.advance.ai/intl/openapi/identity-risk/idvs-h5/ekyc/v1/get-result
POST (application/json)

https://vn-api.advance.ai/intl/openapi/identity-risk/idvs-h5/ekyc/v1/get-result
POST (application/json)

Request Header Parameters

Parameter	Description
X-ACCESS-TOKEN	`string` Please use Token Authentication API to get your access token

Request Parameters

Parameter	Description
signatureId	`string` SignatureId which can use it to get the Face Authentication result

Response Description

Parameter	Description
code	Response's Status Code
transactionId	The request id, the max length is 64
pricingStrategy	`Deprecated`, Always return `FREE`
message	Status Code Explanation
data	`object` : the business result of Face Authentication
extra	Extra response info (Exception Message)

Response.code

Status Code	Message
SUCCESS	OK
SIGNATURE_NOT_EXIST	This signatureId is not exist.
ERROR	Server error.

Response.data

Field	Description
signatureId	`string`, the signatureId of this verification transaction.
overallResult	`string`, The result code of this verification transaction.
idvResult	`string`, The result code of this verification transaction. (will be deprecated, use `overallResult` instead)
errorCode	`string`, The fail reason when overallResult is `FAIL` or `INCOMPLETE`
faceDetail	`object`, The face verification result details. Refer to FaceDetail
countryCodeIso3	`string`, the `region` in the Generate URL API 's input.
inputParameters	`object`, The request parameters that from Generate URL API. Refer to InputParameters

overallResult

overallResult is the result code of the Face Authentication

Value	Description
PASS	the user passed the Face Authentication check.
FAIL	the user failed the Face Authentication check.
INCOMPLETE	the user gave up in the middle of the Face Authenticationcheck, or the user timeouts.

errorCode

Response.data.overallResult	Value	Description
PASS	SUCCESS	The user passed the Face Authentication.
FAIL	LIVENESS_ATTACK	Liveness Detection Failed. True if faceDetail.faceLivenessScore < 50.0, else False.
	SIMILARITY_FAILED	Face Comparison Failed. True if faceDetail.faceSimilarityScore < faceComparisonThreshold, else False.
	UNABLE_GET_IMAGE	User needs to enroll first.
INCOMPLETE	PARAMETER_ERROR	The data submitted by our frontend is not valid. This may indicate a frontend bug.
	USER_TIMEOUT	User did not complete the operation within the specified time（1 hour）
	RETRY_COUNT_REACH_MAX	The user's retry count reaches max.
	FACE_QUALITY_TOO_POOR	Face quality is too poor for face comparison or liveness.
	ERROR	Error during processing in our backend. This may indicate a backend bug.

Response Examples

SUCCESS

{
  "code": "SUCCESS",
  "message": "OK",
  "data": {
    "signatureId": "f302f5d2454a85c2",
    "overallResult": "PASS",
    "idvResult": "PASS",
    "errorCode": "SUCCESS",
    "faceDetail": {
      "faceResult": "PASS",
      "faceImageFar": "https://abc.com/faceImageFar.jpg",
      "faceImageNear": "https://abc.com/faceImageNear.jpg",
      "auditImageUrl": "https://abc.com/auditImage.zip",
      "faceLivenessScore": 99,
      "faceSimilarityScore": 82,
      "eventDetails": [
        {
          "event": "FE_DOCUMENT_SCAN",
          "result": "PASS",
          "createTimestmap": 1665993522952
        }
      ]
    },
    "feeDetail": [
      {
        "name": "SOLUTION",
        "type": "SOLUTION"
      }
    ],
    "countryCodeIso3": "PHL"
  },
  "extra": null,
  "transactionId": "d3fde1547eeaf226",
  "pricingStrategy": "FREE"
}

{
  "code": "SUCCESS",
  "message": "OK",
  "data": {
    "signatureId": "f302f5d2454a85c2",
    "overallResult": "FAIL",
    "idvResult": "FAIL",
    "errorCode": "LIVENESS_ATTACK",
    "faceDetail": {
      "faceResult": "FAIL",
      "faceImageFar": "https://abc.com/faceImageFar.jpg",
      "faceImageNear": "https://abc.com/faceImageNear.jpg",
      "auditImageUrl": "https://abc.com/auditImage.zip",
      "faceLivenessScore": 0.0,
      "faceSimilarityScore": 82.0
    },
    "countryCodeIso3": "PHL"
  },
  "extra": null,
  "transactionId": "d3fde1547eeaf226",
  "pricingStrategy": "FREE"
}

SIGNATURE_NOT_EXIST

{
    "code":"SIGNATURE_NOT_EXIST",
    "message":"This signatureId is not exist",
    "data":null,
    "extra":null,
    "transactionId":"b6d722f7e9f553ae",
    "pricingStrategy":"FREE"
}

ERROR

{
    "code":"ERROR",
    "message":"Server error",
    "data":null,
    "extra":null,
    "transactionId":"1deae5a13ef2bd5e",
    "pricingStrategy":"FREE"
}

{
    "code":"SIGNATURE_NOT_EXIST",
    "message":"This signatureId is not exist",
    "data":null,
    "extra":null,
    "transactionId":"b6d722f7e9f553ae",
    "pricingStrategy":"FREE"
}

ERROR

{
    "code":"ERROR",
    "message":"Server error",
    "data":null,
    "extra":null,
    "transactionId":"1deae5a13ef2bd5e",
    "pricingStrategy":"FREE"
}