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 |
ID | NUMBER | Output Document Number |
Name |
| 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. |
Gender | GENDER | Output "F" or "M" |
Date of Birth | DATE_OF_BIRTH | Output format unified as yyyy/mm/dd |
Expiration Date | DATE_OF_EXPIRY | Output format unified as yyyy/mm/dd |
Issuance Date | DATE_OF_ISSUE | Output format unified as yyyy/mm/dd |
Nationality | NATIONALITY | Output the full name of the country in English |
Nationality Code | NATIONALITY_CODE | Output the corresponding three-letter country code |
Country of Birth | COUNTRY_OF_BIRTH | Output the full name of the country of birth in English |
Country of Birth Code | COUNTRY_OF_BIRTH_CODE | Output the corresponding three-letter country code for the country of birth |
Issuing Country | ISSUE_STATE | Output the full name of the issuing country in English |
Issuing Country Code | ISSUE_STATE_CODE | Output the corresponding three-letter country code for the issuing country |
Address | ADDRESS | Output Address |
MRZ | MRZ1 | 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.