> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# JSON File for MRZ

> JSON file format for machine-readable zone (MRZ) data exported by ABBYY FineReader Engine — attribute-value pairs and array data for ID document fields.

JavaScript Object Notation (JSON) is an open-standard, language-independent file format to transmit data objects consisting of attribute–value pairs and array data types.

The table below describes the format of machine-readable zone (MRZ) data when exported to a JSON file.

## Description of JSON format

<table><tbody><tr><td><p><strong>Name</strong></p></td><td><p><strong>Type</strong></p></td><td><p><strong>Nested keys</strong></p></td><td><p><strong>Description</strong></p></td></tr><tr><td rowspan="2"><p><a name="fields_json" /><strong>Fields</strong></p></td><td rowspan="2"><p>Object</p></td><td><p><strong>BirthDate </strong>— Document holder's date of birth.</p><p><strong>DocumentNumber</strong> — The document number.</p><p><strong>ExpiryDate </strong>— The document's expiry date.</p><p><strong>PersonalNumber</strong> — Document holder's personal number.</p><p>Type: object. Nested keys:</p><ul><li><strong><a href="/fine-reader/engine/specifications/export-formats/json-file-for-mrz#chars">Chars</a></strong></li><li><strong><a href="/fine-reader/engine/specifications/export-formats/json-file-for-mrz#checksum">Checksum</a></strong></li><li><strong><a href="/fine-reader/engine/specifications/export-formats/json-file-for-mrz#region">Region</a></strong></li><li><strong><a href="/fine-reader/engine/specifications/export-formats/json-file-for-mrz#value">Value</a></strong></li></ul></td><td><p>Contains the fields extracted from MRZ.</p></td></tr><tr><td><p><strong>DocumentType</strong> —<strong> </strong>The document type.</p><p><strong>DocumentSubtype</strong> — The document subtype.</p><p><strong>GivenName</strong> —<strong> </strong>One or several given names of the document holder.</p><p><strong>IssuingCountry</strong> — Code of issuing state.</p><p><strong>LastName</strong> — Document holder's surname.</p><p><strong>Nationality</strong> — Document holder's nationality.</p><p><strong>Sex</strong> — Document holder's sex.</p><p>Type: object. Nested keys:</p><ul><li><strong><a href="/fine-reader/engine/specifications/export-formats/json-file-for-mrz#chars">Chars</a></strong></li><li><strong><a href="/fine-reader/engine/specifications/export-formats/json-file-for-mrz#region">Region</a></strong></li><li><strong><a href="/fine-reader/engine/specifications/export-formats/json-file-for-mrz#value">Value</a></strong></li></ul></td><td><br /></td></tr><tr><td><p><a name="lines_json" /><strong>Lines</strong></p></td><td><p>Object</p></td><td><p><strong>Line1 </strong>— The first line of MRZ.</p><p><strong>Line2 </strong>— The second line of MRZ.</p><p><strong>Line3 </strong>— The third line of MRZ.</p><p>Type: object. Nested keys:</p><ul><li><strong><a href="/fine-reader/engine/specifications/export-formats/json-file-for-mrz#region">Region</a></strong></li><li><strong><a href="/fine-reader/engine/specifications/export-formats/json-file-for-mrz#value">Value</a></strong></li></ul></td><td><p>Contains 2 or 3 lines extracted from MRZ.</p></td></tr><tr><td><p><a name="chars" /><strong>Chars</strong></p></td><td><p>Array</p></td><td><p>Several objects, each corresponding to a character in the recognized text. Nested keys for each object:</p><ul><li><strong><a href="/fine-reader/engine/specifications/export-formats/json-file-for-mrz#rect">Rect</a></strong></li><li><strong>Suspicious</strong> — optional key, present only when the character was recognized uncertainly, when its value is true. Type: boolean.</li><li><strong><a href="/fine-reader/engine/specifications/export-formats/json-file-for-mrz#value">Value</a></strong></li></ul></td><td><p>Contains the characters of the text in the reading order.</p></td></tr><tr><td><p><a name="checksum" /><strong>Checksum</strong></p></td><td><p>Object</p></td><td><p><strong>IsVerified</strong> — is true if the recognized checksum digit matches the value of the checksum calculated over the recognized field string, false otherwise. Type: boolean.</p><p><strong><a href="/fine-reader/engine/specifications/export-formats/json-file-for-mrz#value">Value</a></strong> — the recognized value of the checksum. Type: string.</p></td><td><p>The check digit over the whole MRZ or one of its fields.</p></td></tr><tr><td><p><a name="region" /><strong>Region</strong></p></td><td><p>Array</p></td><td><p>Several <strong><a href="/fine-reader/engine/specifications/export-formats/json-file-for-mrz#rect">Rect</a></strong> keys in top-to-bottom order.</p></td><td><p>A region containing the line or the field. It consists of several non-overlapping rectangles.</p></td></tr><tr><td><p><a name="rect" /><strong>Rect</strong></p></td><td><p>Array</p></td><td><p>Four integer values, containing the coordinates of the rectangle in the following order: left, top, right, bottom.</p></td><td><p>A rectangle.</p></td></tr><tr><td><p><a name="value" /><strong>Value</strong></p></td><td><p>String</p></td><td><p>No nested keys.</p></td><td><p>A string value of a field, character, line, etc.</p></td></tr></tbody></table>

## See also

[IMrzData::ExportToFile](/fine-reader/engine/api-reference/document-related-objects/mrzdata/exporttofile-method)

[IMrzData::ExportToFileEx](/fine-reader/engine/api-reference/document-related-objects/mrzdata/exporttofileex-method)