Success Response

Return Model

The following properties will be returned for this model:

KeyTypeDescriptionPossible values

IsAuthenticFinal

bool

Final classification as to whether the input image is fraudulent or not. This is determined based on the other boolean values returned by the service.

- True: Image is authentic i.e., non-fraudulent - False: Image is not authentic i.e., has been tampered with

DataProperties

Name

str

Name of the forensic check performed.

- MetadataChecks: Denotes that the meta-data check has been performed. - GrayscaleCheck: Denotes that the grayscale check has been performed. - SecurityZoneCheck: Denotes that the security-zone check has been performed. - PhotocopyCheck: Denotes that the photocopy/scan check has been performed. - SpliceDetectionCheck: Denotes that splice detection has been performed.

IsValid

bool

Signifies whether the document is valid, based on the forensic check performed.

- True: Indicates that the input image passed the forensic check is considered a valid image. - False: Indicates that the input image failed the forensic check and is therefore considered invalid.

Message

str

Message which interprets the result of the forensic check, or states the error message as to why the check failed.

For MetadataChecks: - Success: The image's meta-data is correct. - Image has been edited in Photoshop: Suggests that the image has been manipulated using Adobe Photoshop. - EXIF data has been stripped: Metadata is missing. - Camera/ Phone make and model info not contained, or image has been scanned: Camera make and model is not contained. - Image has been edited: Indicates that the image has been manipulated using editing software (the identified editing software will also be displayed). For GrayscaleCheck: - Image is grayscale: Image has been identified as grayscale. - Image is NOT grayscale: Image is not grayscale. For SecurityZoneCheck: - Success: All required security zones are present and are correctly positioned. - Incorrect number of regions of interest found: The input ID contains an incorrect number of security zones. - Document is invalid, regions of interest are in incorrect locations: Security zones are mis-positioned. For PhotocopyChecks: - ID Document not detected in image: An ID has not been detected in the input image. - Document has been scanned with XXX% confidence: States the confidence that the input image has been scanned/ photocopied. - Document is real with XXX% confidence: States the confidence that the input image is real i.e., has not been scanned/photocopied. For RecaptureCheck: - Image has been recaptured with XXX% confidence: Indicates that the image has been recaptured with XXX% confidence. - Image has NOT been recaptured with XXX% confidence: Indicates that the image has NOT been recaptured with XXX% confidence. For SpliceDetectionCheck: - Image is spliced with XXX% confidence: Denotes that the image has been spliced with XXX% confidence. - Image is NOT spliced with XXX% confidence: Indicates that the image has not been spliced with XXX% confidence.

DataAttributes

dict

Contains all additional information pertaining to the forensic check conducted.

For SecurityZoneChecks: - SecZoneRegions (dict): Contains the security zone names as keys, along with detection confidence scores as values. - DocType (str): - new_kenya_id_card_front: Front of the new Kenyan ID card has been detected. - new_kenya_id_card_back: Back of the new Kenyan ID card has been detected. - old_kenya_id_card_front: Front of the old Kenyan ID card has been detected. - old_kenya_id_card_back: Back of the old Kenyan ID card has been detected. - Unknown: Otherwise. For PhotocopyCheck: - IsScannedProb (float): Probability that the input image has been scanned/photocopied.

For RecaptureCheck: - IsRecapturedProb (float): Probability that the input image has been recaptured (from another device's screen). For SpliceDetectionCheck: - IsSplicedProb (float): Probability that the input image has been sliced. - SpliceMap (np.array): Heatmap illustrating the region(s) that has been identified as spliced.

Last updated