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 :

  1. ID_NUMBER_ORIGINAL
  2. ID_NUMBER
  3. DOCUMENT_NUMBER
  4. PERSONAL_NUMBER
  5. NIK
  6. TAX_NUMBER
  • NUMBER

Output Document Number

The field representing name includes the following :

  1. FULL_NAME
  2. LOCAL_NAME
  3. NAME
  4. TNAM
  5. LAST_NAM
  6. PNAME1
  7. PNAME2
  8. FIRST_NAME
  9. MIDDLE_NAME
  10. FULL_NAME_N
  11. EFIRST_NAME_FULL
  12. NAME_CN
  13. FIRST_NAME_N
  14. EFIRST_NAME
  15. CNAME2
  16. CNAME1
  17. ELAST_NAME
  18. LAST_NAME_N
  • LAST_NAME (Local Language)
  • MIDDLE_NAME (Local Language)
  • FIRST_NAME (Local Language)
  • FULL_NAME (Local Language)
  • LAST_NAME_EN (English)
  • MIDDLE_NAME_EN (English)
  • FIRST_NAME_EN (English)
  • FULL_NAME_EN (English)

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 :

  1. SEX
  2. GENDER
  3. SEX_N
  • GENDER

Output "F" or "M"

The field representing date of birth includes the following :

  1. DATE_OF_BIRTH
  2. BIRTH_DATE
  3. DOB
  • DATE_OF_BIRTH

Output format unified as yyyy/mm/dd

The field representing date of issue includes the following :

  1. DATE_OF_ISSUE
  2. ISSUE_DATE
  • DATE_OF_ISSUE

Output format unified as yyyy/mm/dd

The field representing date of expiry includes the following :

  1. DATE_OF_EXPIRY
  2. DATE_OF_EXPIR
  3. EXPIRE_DATE
  4. DATE_EXPIRE
  5. EXPRIFY_DATE
  6. EXPIRY_DATE
  • DATE_OF_EXPIRY

Output format unified as yyyy/mm/dd

The field representing nationality includes the following :

  1. NATIONALITY
  2. NATIONALITY_N
  • NATIONALITY

Output the full name of the country in English

The field representing nationality code includes the following :

  1. NATIONALITY_CODE
  • NATIONALITY_CODE

Output the corresponding three-letter country code

The field representing country of birth includes the following :

  1. COUNTRY_OF_BIRTH
  • COUNTRY_OF_BIRTH

Output the name of the country of birth in English

The field representing country code for the country of birth includes the following :

  1. COUNTRY_OF_BIRTH_CODE
  • COUNTRY_OF_BIRTH_CODE

Output the corresponding three-letter country code for the country of birth

The field representing issue state includes the following :

  1. ISSUE_STATE
  2. ISSUING_STATE
  • ISSUE_STATE

Output the name of the issuing country in English

The field representing country code for the issuing country includes the following :

  1. ISSUE_STATE_CODE
  2. ISSUING_STATE_CODE
  • ISSUE_STATE_CODE

Output the corresponding three-letter country code for the issuing country

The field representing address includes the following :

  1. ADDRESS_ORIGINAL
  2. ADDRESS
  3. ADDRESS_N
  • ADDRESS

Output Address

The field representing MRZ includes the following :

  1. MRZ_TYPE
  2. MRZ_STRINGS
  3. MRZ_LINES
  • MRZ1

Output MRZline

  1. 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

  1. 00000001003
  2. 00000001006

Australia

  1. 00610000001
  2. 00610000002
  3. 00610000003
  4. 00610000004
  5. 00610000005
  6. 00610000006
  7. 00610000007
  8. 00610000008
  9. 00610000009
  10. 00610000010
  11. 00610000013
  12. 00610000014
  13. 00610000015
  14. 00610000016
  15. 00610000017

Bangladesh

  1. 00880000003
  2. 00880000002

Barbados

  1. 00124600001
  2. 00124600002

Belgium

  1. 00320000001
  2. 00320000002
  3. 00320000003
  4. 00320000004
  5. 00320000005
  6. 00320000006
  7. 00320000007
  8. 00320000009
  9. 00320000010
  10. 00320000011

Botswana

  1. 00267000001
  2. 00267000002

Brazil

  1. 00550000001
  2. 00550000002
  3. 00550000003
  4. 00550000004

China

  1. 00860000001
  2. 00860000006
  3. 00860000007
  4. 00860000011
  5. 00860000925
  6. 00860000888

China,Macau

  1. 08530000001
  2. 08530000003
  3. 08530000002

China,Taiwan

  1. 08860000001
  2. 08860000003
  3. 08860000002

Colombia

  1. 00570000001
  2. 00570000002
  3. 00570000003

Ghana

  1. 00233000001
  2. 00233000002

Indonesia

  1. 00620000001

Jamaica

  1. 00187600001
  2. 00187600002
  3. 00187600003
  4. 00187600004

Jordan

  1. 00962000001
  2. 00962000002

Kenya

  1. 00254000002
  2. 00254000003

Liechtenstein

  1. 04230000001
  2. 04230000002

Malaysia

  1. 00600000001

Nepal

  1. 00977000001
  2. 00977000002

Nigeria

  1. 00234000001
  2. 00234000002

Philippines

  1. 00630000001
  2. 00630000002
  3. 00630000036
  4. 00630000004
  5. 00630000024
  6. 00630000020
  7. 00630000016
  8. 00630000017
  9. 00630000022
  10. 00630000033
  11. 00630000031
  12. 00630000032
  13. 00630000034
  14. 00630000037
  15. 00630000038

South Korea

  1. 00820000001
  2. 00820000002

Thailand

  1. 00660000001

Turkey

  1. 00900000001
  2. 00900000002

United Arab Emirates

  1. 09710000001
  2. 00971000002
  3. 00971000003

Vietnam

  1. 00840000001

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.