Authenticity Checks

overview the authenticitycheck section of the api response is critical for assessing the security features and integrity of identification documents it includes various checks to ensure the authenticity of the document by examining security texts, image patterns, embedded photos, barcodes, and electronic liveness features explanation of values indicates that the authenticity feature or check has passed indicates that the authenticity feature or check has failed indicates that the check was not applicable or could not be performed authenticity checks below is the detailed breakdown of each parameter within the authenticitycheck object parameter sub parameter data type possible values description authenticitycheck object container for all authenticity verification results ocrsecuritytext object details results from ocr security text checks elementresult boolean true , false , none result of the ocr text check elementdiagnose string various diagnosis based on ocr text check, e g , text color discrepancies imagepattern object results from image pattern checks elementresult boolean true , false , none result of the image pattern check elementdiagnose string various diagnosis of image pattern integrity elementtype string various type of pattern checked, e g , blank areas, embedded images image string url url to the image under scrutiny etalonimage string url url to the reference image for comparison photoembedtype object results from checks on the embedded photo type elementresult boolean true , false , none result of the photo embedding check elementdiagnose string various diagnosis based on the type of photo embedding elementtype string various type of photo embedding checked liveness object results from document liveness checks elementresult boolean true , false , none result of the liveness check elementdiagnose string various diagnosis of document liveness features elementtype string various type of liveness feature checked barcodeformatcheck object results from barcode format verification elementresult boolean true , false , none result of the barcode format check elementdiagnose string various diagnosis based on the barcode format check elementtype string various type of barcode checked usage and implications these checks are designed to detect and diagnose potential security issues related to document authenticity, such as forged text, manipulated photos, incorrect barcode formats, and compromised document features the results can trigger additional verification steps, requests for other forms of identification, or outright rejection of suspicious documents example if the ocrsecuritytext check returns false with a diagnosis of "text color should be blue", it indicates that the text colour on the document does not match expected security specifications, suggesting possible tampering or forgery this would typically prompt a deeper investigation into the document's authenticity or request additional proof of identity from the user this comprehensive approach ensures that only genuine documents pass through the verification process, maintaining the integrity of the system and protecting against identity fraud table of authenticity check objects this table provides an overview of the main security feature checks that might be performed during the document verification process, detailing the types of checks and their specific purposes which will be the main object names inside authenticity checks table of security feature checks object names security feature name description uv luminescence checks the document's luminescence under uv light to verify the presence of security inks ir b900 verifies the contrast of b900 ink in the machine readable zone (mrz) under infrared light, essential for passport and id authentication image pattern examines the presence or absence of specific image patterns, including their position, shape, and color, to detect tampering or alterations axial protection confirms the integrity of laminate and other protective layers under axial lighting, ensuring the document's physical security features are intact uv fibers detects the presence of protective fibers that are visible under uv light, typically used in high security documents to prevent forgery ir visibility checks for the visibility of document elements under infrared light, which can reveal modifications not visible under normal light ocr security text uses optical character recognition to compare text fields under uv light against other sources, verifying text integrity and detecting alterations ipi visualizes invisible personal information (ipi), which can contain hidden security features or personal data embedded within the document photo embed type assesses how the owner's photo is embedded in the document, whether printed directly or affixed, a critical factor in photo id security ovi checks optical variable ink, which changes color when viewed from different angles, a sophisticated anti counterfeiting feature holograms verifies the presence and integrity of holograms, used as a security measure against photocopying and digital tampering photo area conducts an advanced check of the owner's photo area, assessing photo shape, size, and position to ensure compliance with issuing standards portrait comparison compares the printed portrait against other images (such as chip or live capture) to verify identity and detect substitution or tampering barcode format check evaluates the barcode format, including metadata, data content, and structural integrity, ensuring it meets specified standards kinegram verifies kinegrams, which are dynamic images that appear to move or change as the viewing angle changes, enhancing document security letter screen checks for letter screen patterns, which are fine prints and details that cannot be accurately reproduced through scanning or photocopying hologram detection detects and validates the presence and condition of holograms, ensuring they have not been altered or removed fingerprint comparison compares fingerprints on the document with registered or live captured fingerprints to verify identity and prevent fraud liveness conducts checks to verify that the document or its features are presented in a live session, preventing the use of replicas or modified copies extended ocr check performs a detailed ocr check beyond basic text recognition, analyzing text layout, font consistency, and other advanced features extended mrz check conducts a comprehensive check of the machine readable zone, assessing formatting, encoding standards, and error correction measures table of elementdiagnose authenticity check types contains identificators that determine the result of the text field comparison from the different sources diagnostic code description unknown the outcome of the check is indeterminate pass the check completed successfully without any issues invalid input data input data provided is incorrect or insufficient for processing internal error an internal error occurred within the system during processing exception in module an unexpected exception occurred within a processing module uncertain verification verification results are inconclusive necessary image not found required image for the check was not found photo sides not found essential sides of the photo required for verification are missing invalid checksum the checksum for the data did not validate correctly syntax error error in the syntax of data or query logic error logical error in process or workflow sources comparison error errors encountered while comparing data from different sources fields comparison logic error logical errors in the comparison of document fields invalid field format field formats are invalid or unrecognized true luminescence error incorrect luminescence properties detected, indicating potential forgery false luminescence error false luminescence detected, suggesting tampering fixed pattern error the fixed pattern on the document does not match expected standards low contrast in ir light document shows low contrast under infrared light incorrect background light background lighting conditions are inappropriate for verification background comparison error errors in comparing the document background to standards incorrect text color text color on the document does not match expected standards photo false luminescence detected unnatural luminescence in the photo area, indicating potential fraud too much shift the document or a part of it has shifted excessively, possibly due to manipulation contact chip type mismatch the type of contact chip does not match the expected type, suggesting discrepancies fibers not found security fibers expected in the document are missing, indicating potential counterfeiting too many objects an excessive number of objects detected in the document that should not exist, suggesting alterations specks in uv specks detected under uv light examination, which could indicate tampering too low resolution the document's image resolution is too low for accurate analysis, potentially hiding details invisible element present an element that should be invisible under normal conditions is visible, indicating a flaw visible element absent an element that should be visible is missing, suggesting potential document tampering element should be colored an element that should have colour is not colored, indicating a printing error or manipulation element should be grayscale an element that should be grayscale is incorrectly colored, possibly due to printing issues photo white ir dont match discrepancies between the photo under white light and infrared light suggest tampering uv dull paper mrz the mrz area of the paper is dull under uv light examination, which may indicate issues with document authenticity false luminescence in mrz detected false luminescence in the mrz area, suggesting potential security feature tampering uv dull paper photo the photo area of the paper is dull under uv light examination, potentially indicating counterfeit material uv dull paper blank blank areas of the paper are dull under uv light, possibly indicating a lack of proper security coatings uv dull paper error general error related to uv dullness in paper, indicating possible production or authenticity issues false luminescence in blank false luminescence detected in blank areas of the document, suggesting unauthorized material or ink use bad area in axial bad area detected during axial light examination, potentially due to improper lamination or damage false ip parameters incorrect intellectual property parameters found, suggesting non compliance or counterfeit details field pos corrector highlight ir issues detected with field position under ir highlighting, indicating potential alterations field pos corrector glares in photo area glares detected in the photo area during field position correction, affecting image clarity field pos corrector photo replaced indications that the photo has been replaced, suggesting document tampering or identity fraud field pos corrector landmarks check error errors in checking facial landmarks during field position correction, affecting biometric verification field pos corrector face presence check error face presence check failed during field position correction, indicating possible photo substitution field pos corrector face absence check error face absence erroneously detected during field position correction, potentially due to poor image quality or sensor error ovi ir invisible optical variable ink (ovi) is invisible under infrared light, suggesting a lack of proper ink usage ovi insufficient area the area covered by optical variable ink is insufficient, indicating potential cutting corners in document security features ovi color invariable the color of the ovi does not change under different viewing angles, indicating a potential issue with the ink quality ovi bad color front the front color of the ovi is incorrect, suggesting incorrect application or ink quality issues ovi bad color side the side color of the ovi is incorrect, which may point to issues with the application process or ink quality ovi wide color spread the color spread of the ovi is too wide, potentially indicating a dispersion or application error ovi bad color percent the percentage of color change in the ovi does not meet the specified standards, suggesting potential fraud hologram element absent a required hologram element is absent from the document, indicating a critical missing security feature hologram side top images absent top images expected on the hologram side are absent, indicating a missing security feature hologram element present the required hologram element is present, confirming the security feature hologram frames is absent frames that should surround the hologram are missing, suggesting potential tampering hologram holo field is absent the holographic field expected on the document is absent, indicating a crucial security flaw photo pattern interrupted the continuous pattern in the photo area is interrupted, which could indicate tampering photo pattern shifted the pattern in the photo area has shifted from its expected position, suggesting manipulation photo pattern different colors colors in the photo pattern do not match expected standards, indicating a possible forgery photo pattern ir visible the photo pattern, which should not be visible under infrared light, is detected, suggesting incorrect materials photo pattern not intersect patterns that should intersect do not, indicating a misalignment or editing photo size is wrong the size of the photo does not meet the specified dimensions, indicating potential fraud photo pattern invalid color the color of the photo pattern is incorrect, suggesting the use of non standard materials photo pattern shifted vert the photo pattern is vertically shifted, which could indicate physical tampering photo pattern pattern not found the expected pattern in the photo area is not found, indicating a missing security element photo pattern different lines thickness line thickness in the photo pattern varies, which should not occur if genuine photo is not rectangle the photo is not in the standard rectangular shape, suggesting alteration photo corners is wrong the corners of the photo do not match the expected specifications, indicating possible tampering document is cancelling indicates that the document has been marked as cancelled, typically found in voided or invalidated documents text color should be blue text that should be blue is incorrectly colored, suggesting a printing error or manipulation text color should be green green text is found to be incorrectly colored, indicating potential forgery text color should be red red text is incorrectly presented, which could indicate tampering text should be black text that should be black is found in another color, suggesting a critical error in document production barcode was read with errors the barcode could not be read correctly, indicating potential issues with its formatting or damage barcode data format error the data format of the barcode does not match expected specifications, indicating potential manipulation barcode size params error the size parameters of the barcode do not meet the required standards, suggesting a discrepancy not all barcodes read not all barcodes on the document could be read, which may indicate damage or intentional obfuscation glares in barcode area glares detected in the barcode area interfere with reading, potentially due to improper document handling or printing portrait comparison portraits differ differences detected between portraits that should be identical, suggesting possible fraud portrait comparison no service reply the service expected to reply to a portrait comparison did not respond, hindering verification portrait comparison service error an error occurred within the portrait comparison service, affecting the outcome portrait comparison not enough images insufficient images available for effective portrait comparison, limiting verification capabilities portrait comparison no live photo no live photo available for comparison against the document portrait, necessary for certain checks portrait comparison no service license the license for the portrait comparison service is absent or expired, preventing comparison portrait comparison no portrait detected no portrait could be detected for comparison purposes, suggesting a potential issue with the document or image quality mobile images unsuitable light conditions light conditions for images taken with a mobile device are unsuitable, affecting image quality and verification mobile images white uv no difference no difference detected between images under white and uv light, which is unusual and may indicate issues fingerprints comparison mismatch mismatch found during fingerprint comparison, suggesting discrepancies between registered data and the document holo photo face not detected no face detected in the holographic photo, which is necessary for certain security verifications holo photo face comparison failed the face comparison within the holographic photo failed, suggesting discrepancies or poor quality holo photo glare in center absent expected glare in the center of a holographic photo is absent, indicating a potential security feature issue holo photo holo element shape error the shape of the holographic element does not match specifications, suggesting tampering or error holo photo algorithms steps error errors detected in the algorithmic steps used for analyzing holographic photos, affecting the outcome holo photo holo areas not loaded holographic areas in the photo did not load correctly, potentially due to file corruption or loading errors holo photo finished by timeout the holographic photo analysis timed out before completion, suggesting processing issues holo photo document outside frame the document is positioned outside the frame in the holographic photo, indicating potential misalignment or improper handling liveness depth check failed depth check for liveness verification failed, suggesting the document may not be genuine mrz quality wrong symbol position symbols in the mrz are positioned incorrectly, suggesting potential errors in document printing mrz quality wrong background the background of the mrz does not meet the specified quality standards, potentially affecting readability mrz quality wrong mrz width the width of the mrz is incorrect, which could indicate a printing or specification error mrz quality wrong mrz height the height of the mrz does not match required specifications, suggesting a potential error in production mrz quality wrong line position lines in the mrz are positioned incorrectly, potentially due to printing errors mrz quality wrong font type the font type used in the mrz is incorrect, which may indicate unauthorized production or tampering ocr quality text position the position of text analyzed using ocr does not meet quality standards, affecting data extraction accuracy ocr quality invalid font the font used in ocr processed text is invalid, suggesting discrepancies or errors ocr quality invalid background the background for ocr processed text is invalid, potentially affecting text recognition lasink invalid lines frequency the frequency of lines in lasink security features does not match expected standards, indicating potential issues doc liveness electronic device detected electronic device detected during document liveness checks, suggesting the presence of a fake or modified document doc liveness invalid barcode background the background for barcode areas during liveness checks does not meet standards, indicating potential tampering chd icao idb base32 error error in processing chd icao idb information encoded in base32, affecting data integrity chd icao idb zipped error zipped data in chd icao idb cannot be processed correctly, suggesting corruption or errors chd icao idb message zone empty the message zone in chd icao idb is empty, which is table of elementtype authenticity check types contains identifiers determining type of features for a document authenticity checks name description blank checks for unmodified blank elements in the document fill verifies the integrity of personalization elements photo assesses the photo for tampering or substitution mrz verifies the machine readable zone for alterations false luminescence detects unnatural luminescence from the document holo simple checks for the presence and integrity of static holograms holo verify static verifies static holograms against known patterns holo verify multi static multiple static hologram verification holo verify dynamic dynamic hologram verification for movement and light changes pattern not interrupted ensures patterns on the document are continuous without breaks pattern not shifted checks for shifts in the document's printed patterns pattern same colors verifies color consistency in patterned areas pattern ir invisible checks for pattern visibility under infrared light photo size check verifies the size of the photo against expected dimensions portrait comparison compares the document portrait against other images for consistency barcode validates barcode format and data integrity ocr optical character recognition accuracy check liveness depth verifies depth in portrait images to detect overlays or paper copies micro text checks for the presence and accuracy of microtext fluorescent object detects fluorescent markers used in secure document printing landmark check assesses facial landmarks in the document's portrait for consistency face presence checks for the presence of a facial image liveness screen capture detects attempts to use a screen capture as a live image during verification liveness electronic device checks for signs of electronic device use in presenting the document image check digital signature validates the digital signature embedded in the document contact chip classification contact chip check, verifying chip presence and function table of elementresult outcomes this table succinctly describes the possible outcomes of the elementresult in the context of document security checks parameter description true the security check passed, confirming the document's authenticity false the security check failed, indicating potential issues or tampering none the security check was not applicable or could not be executed