API Documentation

Compare Face

This method helps you to compare face between 2 images


You will receive a response consists of message and an error code if the request fails to process. The following is a list of error codes.

Error statusError codeDescription
200FAIL_ON_1fail on liveness
200FAIL_ON_2fail on attribute
200FAIL_ON_3fail on liveness and attribute
200FAIL_ON_4fail on quality
200FAIL_ON_5fail on liveness and quality
200FAIL_ON_6fail on attribute and quality
200FAIL_ON_7fail on liveness, attribute, and quality
200FAIL_ON_8fail on number of face (nface)
200FAIL_ON_9fail on number of face (nface) and liveness
200FAIL_ON_10fail on number of face (nface) and attribute
200FAIL_ON_11fail on number of face (nface), attribute, and liveness
200FAIL_ON_12fail on number of face (nface) and quality
200FAIL_ON_13fail on number of face (nface), quality, and liveness
200FAIL_ON_14fail on number of face (nface), quality, and attribute
200FAIL_ON_15fail on number of face (nface), quality, attribute, and liveness
200FAIL_ON_16fail on similarity status
400INVALID_PAYLOADno value in payload or empty string more than 1
400INVALID_PAYLOAD_IMAGE_1_MISSINGinvalid payload image 1 not a standard b64/url or image empty string
400INVALID_PAYLOAD_IMAGE_2_MISSINGinvalid payload image 2 not a standard b64/url or image empty string
400INVALID_PAYLOAD_IMAGE_1_SIZEinvalid payload image 1 size too large
400INVALID_PAYLOAD_IMAGE_2_SIZEinvalid payload image 2 size too large
400MISSING_PAYLOAD_IMAGE_1missing payload image 1
400MISSING_PAYLOAD_IMAGE_2missing payload image 2
400INVALID_PAYLOAD_IMAGE_1_TIMEOUTtimeout getting image 1 from url in 15 seconds
400INVALID_PAYLOAD_IMAGE_2_TIMEOUTtimeout getting image 2 from url in 15 seconds
400INVALID_PAYLOAD_IMAGE_1_FORMATimage unable to be decoded/got from url OR invalid image 1 extension
400INVALID_PAYLOAD_IMAGE_2_FORMATimage unable to be decoded/got from url OR invalid image 2 extension
400FACE_NOT_DETECTEDface not detected from image
400INVALID_PAYLOAD_QUALITY_VALIDATION_DEPENDENCYis_quality must be true if validate_quality true
400INVALID_PAYLOAD_ATTRIBUTE_VALIDATION_DEPENDENCYis_attribute must be true if validate_attribute true
400INVALID_PAYLOAD_LIVENESS_VALIDATION_DEPENDENCYis_liveness must be true if validate_liveness true
400INVALID_PAYLOAD_THRESHOLD_MISSINGthreshold must be basic/moderate/high
403INSUFFICIENT_QUOTA_COMPAREusage reach it quota limit for compare (only appears on testing mode)
403INSUFFICIENT_QUOTA_LIVENESSusage reach it quota limit for liveness (only appears on testing mode)
500INTERNAL_SERVER_ERRORinternal server error
Language
Click Try It! to start a request and see the response here!