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

Request Example:

curl -X POST \
  https://sg-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 Verification 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 Verification
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.
submissionCompleted	`bool`, Indicates whether the frontend data submission is completed.
idvResult	`string`, The result code of this verification transaction. (will be deprecated, use `overallResult` instead)
errorCode	`string`, The fail reason when overallResult is `fail`
docDetail	`object`, The document verification result details. Refer to DocDetail
countryCodeIso3	`string`, the `region` in the Generate URL API 's input.

overallResult

overallResult is the result code of the verification

Value	Description
PASS	the user passed the verification check.
FAIL	the user failed the verification check.
INCOMPLETE	the user gave up in the middle of the verification check, or the user timeouts.
null	the result is still in processing. (but partial results like docDetail may be ready).

errorCode

Response.data.overallResult	Value	Description
PASS	SUCCESS	The user passed the verification.
FAIL	ID_FORGERY_DETECTED	The document ( only the front part if the document is two-side) is forgery.
INCOMPLETE（replaced by `FAIL` when using Document API)	NO_SUPPORTED_CARD	The card type detected from the document image is not supported.
	CARD_TYPE_MISMATCH	The card type detected from the document image doesn't match with the docType from the Generate URL API，or submitted the wrong side of the card.
	CARD_LOW_QUALITY_IMAGE	The document images are too poor to do verification.
	INCOMPLETED_CARD	The card is not completed in the document images.
	CARD_INFO_MISMATCH	The front part and the back part of the two-side document do not match with each other.
	TOO_MANY_CARDS	More than one cards were detected.
	CARD_NOT_FOUND	Can't detect card from the document image.
	OCR_NO_RESULT	Can't extract ocr result from the docImages
	PARAMETER_ERROR	the data submitted by our frontend is not valid. this may indicates a frontend bug.
	USER_TIMEOUT	User did not complete the operation within the specified time（1 hour）
	ERROR	Error during processing in our backend. this may indicates a backend bug.
	NO_SUPPORTED_CARD_CUSTOMIZED	The card type is known but not supported currently. maybe support in the future.
	NO_FACE_DETECTED	No face detected on the front image of the document.
	OCR_FIELD_INVALID	One or more required fields extracted from the document are invalid, incomplete, or do not conform to the expected format/standards
FAIL	NATIONALITY_COMPLIANCE_FAILED	Category: document. The nationality shown on the document is not permitted under the merchant's compliance policy. (eg. restricted jurisdictions)

Response Examples

SUCCESS

{
  "code": "SUCCESS",
  "message": "OK",
  "data": {
    "signatureId": "f302f5d2454a85c2",
    "overallResult": "PASS",
    "submissionCompleted": true,
    "idvResult": "PASS",
    "errorCode": "SUCCESS",
    "docDetail": {
      "ocrResult": "PASS",
      "docFrontImage": "https://abc.com/idFrontImage.jpg",
      "docBackImage": "https://abc.com/idBackImage.jpg",
      "docType": {
        "front": "MY-ID-MYKAD",
        "back": "MY-ID-MYKAD"
      },
      "subDocType": {
        "front": "MY-ID-MYKAD",
        "back": "MY-ID-MYKAD"
      },
      "ocrInfo": {
        "front": {
          "gender": "PEREMPUAN",
          "name": "****** ******",
          "address": "****** ****** ****** ******",
          "idNumber": "************",
          "religion": "",
          "birthday": "1977/10/28",
          "citizen": "MYS"
        },
        "back": {
          "idNumber": "************"
        }
      },
      "qualityLabels": {
        "front": {
          "isBlur": false,
          "isDim": false,
          "isExposure": true
        },
        "back": null
      },
      "forgeryLabels": [
        "photocopy"
      ],
      "eventDetails": [
        {
          "event": "FE_DOCUMENT_SCAN",
          "result": "PASS",
          "createTimestmap": 1665993522952
        }
      ]
    },
    "countryCodeIso3": "PHL"
  },
  "extra": null,
  "transactionId": "d3fde1547eeaf226",
  "pricingStrategy": "FREE"
}

{
    "code": "SUCCESS",
    "message": "OK",
    "data": {
      "signatureId":"f302f5d2454a85c2",
      "overallResult":"fail",
      "submissionCompleted": true,
      "idvResult":"fail",
      "errorCode":"NOT_SUPPORTED_CARD",
      "docDetail":  {
        "docResult": null,
        "docFrontImage": null,
        "docBackImage": null,
				"ocrInfo": null,
        "qualityLabels": null,
        "forgeryLabels": null
      },
      "countryCodeIso3": "PHL"
    },
    "extra": null,
    "transactionId": "d3fde1547eeaf226",
    "pricingStrategy": "FREE"
}

{
  "code": "SUCCESS",
  "message": "OK",
  "data": {
    "overallResult": null, // still in processing
    "submissionCompleted": false,
    "idvResult": null, // still in processing
    "errorCode": null,
    "docDetail": {
      "ocrResult": PASS,
      "docFrontImage": "https://abc.com/idFrontImage.jpg",
      "docBackImage": "https://abc.com/idBackImage.jpg",
      "ocrInfo": {
        "front": {
          "birthday": "OCTOBER 28,1977",
          "name": "**************",
          "birthdayParsed": "1977/10/28",
          "idNumber": "09-*******-*"
        },
        "back": null
      },
       "qualityLabels": {
  				"front": null,
  				"back": null
			},
      "forgeryLabels": null, // in processing
      "eventDetails": [
          {
              "event": "FE_DOCUMENT_SCAN",
              "result": "PASS",
              "createTimestmap": 1665993522952
          }
      ]
    },
    "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"
}