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 |
ID | NUMBER | Output Document Number |
Name |
| To ensure the accuracy and consistency of output results, ZOLOZ will output based on the language on the document without translation. For example, if a Chinese mainland ID card only has the full name in Chinese, the FULL_NAME field will directly output the full name in Chinese as it appears on the document. For fields that do not exist on the document, the field name will be returned with an empty value. |
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 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.