Notification on the Standardization of OCR Output Field Names - Phase Three
Change Background:
To enhance the standardization and consistency of OCR recognition results, ZOLOZ plans to standardize the output field names of OCR, covering fields such as ID, name, gender, date, nationality, issuing country, and address. Given the wide variety of document types involved in current OCR recognition, ZOLOZ will complete the standardization of field formats in three phases.
ZOLOZ began the changes for Phase Three on May 6, 2025, and is expected to complete all changes for Phase Three by June 6, 2025. This announcement outlines the content and scope of the changes for Phase Three.
Change Content:
The following are the contents and scope of this change.
- Standardized Field Scope:
If OCR cannot read any of the fields listed below, ZOLOZ still returns the field name but leaves its value blank. Any additional processing or custom formatting of this output is now entirely customer-managed; ZOLOZ no longer provides customization services.
Field | Standardized Field Name | Description |
The field representing ID includes the following :
|
| Output Document Number |
The field representing name includes the following :
|
| To keep results accurate and consistent, ZOLOZ outputs each data field exactly as it appears on the document—no translation is applied. For example, if a Mainland-China ID shows the holder’s name only in Chinese, the FULL_NAME field will contain that Chinese text. Fields that are not present on the document are still returned, but with empty values. |
The field representing gender includes the following :
|
| Output "F" or "M" |
The field representing date of birth includes the following :
|
| Output format unified as yyyy/mm/dd |
The field representing date of issue includes the following :
|
| Output format unified as yyyy/mm/dd |
The field representing date of expiry includes the following :
|
| Output format unified as yyyy/mm/dd |
The field representing nationality includes the following :
|
| Output the full name of the country in English |
The field representing nationality code includes the following :
|
| Output the corresponding three-letter country code |
The field representing country of birth includes the following :
|
| Output the name of the country of birth in English |
The field representing country code for the country of birth includes the following :
|
| Output the corresponding three-letter country code for the country of birth |
The field representing issue state includes the following :
|
| Output the name of the issuing country in English |
The field representing country code for the issuing country includes the following :
|
| Output the corresponding three-letter country code for the issuing country |
The field representing address includes the following :
|
| Output Address |
The field representing MRZ includes the following :
|
| Output MRZline |
- The scope of documents for the third phase of changes is as follows:
Note: To ensure compatibility between old and new document types, subsequently added document types will also follow the same standardized output specifications. Users can parse and process this information through the unified ocrResultFormat field.
Country/Region | Document Scope |
Afghanistan |
|
Algeria |
|
Angola |
|
Bahrain |
|
Brunei Darussalam |
|
Croatia |
|
Dominican Republic |
|
Ecuador |
|
Egypt |
|
Ethiopia |
|
Hungary |
|
India |
|
Jersey Island |
|
Kuwait |
|
Latvia |
|
Liberia |
|
Libya |
|
Luxembourg |
|
Madagascar |
|
Malawi |
|
Maldives |
|
Mali |
|
Malta |
|
Mexico |
|
Moldova |
|
Monaco |
|
Mongolia |
|
Morocco |
|
Mozambique |
|
Netherlands |
|
Nicaragua |
|
North Macedonia |
|
Norway |
|
Pakistan |
|
Panama |
|
Paraguay |
|
Peru |
|
Poland |
|
Portugal |
|
Qatar |
|
Romania |
|
Russia |
|
Rwanda |
|
Saudi Arabia |
|
Serbia |
|
Sierra Leone |
|
South Africa |
|
South Sudan |
|
Sri Lanka |
|
Sudan |
|
Suriname |
|
Sweden |
|
Switzerland |
|
Syrian Arab Republic |
|
Tajikistan |
|
Tanzania |
|
Togo |
|
Turkey |
|
Turkmenistan |
|
Ukraine |
|
United Kingdom |
|
United States |
|
Uruguay |
|
Uzbekistan |
|
Venezuela |
|
Vietnam |
|
Yemen |
|
Zambia |
|
Change Impact:
ZOLOZ will introduce a new field called ocrResultFormat in ID Recognition-checkresult and Real ID-checkresult to return the standardized OCR output content. For OCR fields that were output prior to this change, their field names and output formats will remain unchanged, ensuring no compatibility issues.