Notification on the Standardization of OCR Output Field Names
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.
Change Background:
Due to historical reasons, the current OCR output field names lack a unified standard, resulting in poor user experience. To improve user experience, ZOLOZ plans to standardize the OCR output field names in phases starting from March 2025.
Change Timeline:
The first phase of changes will officially take effect on March 10, 2025, Beijing time, and is expected to complete all changes in the first phase by April 5, 2025.
The second phase of changes will officially take effect on April 6, 2025, Beijing time, and is expected to complete all changes in the second phase by May 6, 2025.
The third phase of changes will officially take effect on May 6, 2025, Beijing time, and is expected to complete all changes in the third phase by June 6, 2025.
Change Content:
The following are the contents and scope of this change.
Standardized Field Scope:
Explanation: When OCR does not recognize the following fields, ZOLOZ will output the field names with empty values. Additionally, if you wish to further process or customize the content output by ZOLOZ, this will need to be handled by yourself, as ZOLOZ will no longer provide such 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 first phase of changes is as follows:
Note: The scope of documents for the second and third phases will be announced in advance once clarified.
Country/Region | Document Scope |
All countries or regions |
|
Australia |
|
Bangladesh |
|
Barbados |
|
Belgium |
|
Botswana |
|
Brazil |
|
China |
|
China,Macau |
|
China,Taiwan |
|
Colombia |
|
Ghana |
|
Indonesia |
|
Jamaica |
|
Jordan |
|
Kenya |
|
Liechtenstein |
|
Malaysia |
|
Nepal |
|
Nigeria |
|
Philippines |
|
South Korea |
|
Thailand |
|
Turkey |
|
United Arab Emirates |
|
Vietnam |
|
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.