All Products
Search
Document Center

ID Verification:Certificate OCR fields

Last Updated:Feb 27, 2026

This topic lists the OCR output fields for each supported identity document type. All fields are returned as String values.

Global e-Passport

GLB03002

Extracts data from the Machine Readable Zone (MRZ).

FieldDescription
surnameSurname (Latin script, based on MRZ recognition)
given_namesGiven names (Latin script, based on MRZ recognition)
sexSex (F or M)
date_of_birthDate of birth (yyyy-mm-dd format)
passport_numberPassport number
nationalityNationality (3-digit country code)
date_of_expiryDate of expiry (yyyy-mm-dd format)
country_codeCountry code of the passport issuing authority (3-digit country code)

GLB03001

Extracts data from the visual zone of the passport.

FieldDescription
nameName (English)
passport_numberPassport number
nationalityNationality
date_of_birthDate of birth
place_of_birthPlace of birth
date_of_issueDate of issue
date_of_expiryDate of expiry
place_of_issuePlace of issue
sexSex
typeType

China

Mainland China resident identity card

FieldDescription
nameName
id_numberID number
date_of_birthDate of birth
sexSex
addressAddress
ethnicityEthnicity
origin_of_issueIssuing authority
date_of_issueDate of issue
date_of_expiryDate of expiry

Chinese passport

FieldDescription
nameName (English)
name_cnName (Chinese)
passport_numberPassport number
nationalityNationality
date_of_birthDate of birth
place_of_birthPlace of birth
date_of_issueDate of issue
date_of_expiryDate of expiry
place_of_issuePlace of issue
sexSex
typeType

Chinese driver's license

FieldDescription
nameName
id_numberID number
nationalityNationality
sexSex
addressAddress
date_of_birthDate of birth
date_of_first_issueDate of first issue
classAllowed vehicle class
date_of_issueDate of issue
date_of_expiryDate of expiry

Mainland Travel Permits for Hong Kong and Macao Residents

FieldDescription
nameName (English)
name_cnName (Chinese)
id_numberID number
date_of_birthDate of birth
sexSex
date_of_issueDate of issue
date_of_expiryDate of expiry
origin_of_issueIssuing authority

Mainland Travel Permit for Taiwan Residents

FieldDescription
nameName (English)
name_cnName (Chinese)
id_numberID number
date_of_birthDate of birth
sexSex
date_of_issueDate of issue
date_of_expiryDate of expiry
place_of_issuePlace of issue
origin_of_issueIssuing authority

Exit-Entry Permit for Travelling to and from Hong Kong and Macao

FieldDescription
nameName (English)
name_cnName (Chinese)
id_numberID number
date_of_birthDate of birth
sexSex
date_of_issueDate of issue
date_of_expiryDate of expiry
place_of_issuePlace of issue
origin_of_issueIssuing authority

Exit-Entry Permit for Travelling to and from Taiwan

FieldDescription
nameName (English)
name_cnName (Chinese)
id_numberID number
date_of_birthDate of birth
sexSex
date_of_issueDate of issue
date_of_expiryDate of expiry
place_of_issuePlace of issue
origin_of_issueIssuing authority

Permanent residence card

FieldDescription
nameName (English)
name_cnName (Chinese)
id_numberID number
date_of_birthDate of birth
sexSex
date_of_issueDate of issue
date_of_expiryDate of expiry
nationalityNationality

Hong Kong (China)

Hong Kong identity card (2003 version)

FieldDescription
nameName (English)
name_cnName (Chinese)
id_numberID number
name_codeChinese Telecode
date_of_birthDate of birth
sexSex
current_issue_dateDate of registration
first_issue_dateMonth and year of first registration
is_permanentWhether the card is for a permanent resident. Valid values: Y (Yes), N (No).
symbolsSymbol mark. Example: ***AZ.

Hong Kong identity card (2018 version)

FieldDescription
nameName (English)
name_cnName (Chinese)
id_numberID number
name_codeChinese commercial code for name
date_of_birthDate of birth
sexSex
current_issue_dateDate of registration
first_issue_dateMonth and year of first registration
is_permanentWhether the card is for a permanent resident. Valid values: Y (Yes), N (No).
symbolsSymbol mark. Example: ***AZ.

Hong Kong driver's license

FieldDescription
name_cnName (Chinese)
nameName (English)
license_classAllowed vehicle type
date_of_expiryDate of expiry
id_numberID number

Hong Kong taxi driver identity plate

FieldDescription
name_cnName (Chinese)
nameName (English)
date_of_issueDate of issue
date_of_expiryDate of expiry
id_numberID number

Macao (China)

Macao identity card (2023 version)

FieldDescription
surnameSurname (English)
surname_cnSurname (Chinese)
givennameGiven name (English)
givenname_cnGiven name (Chinese)
id_numberID number
date_of_birthDate of birth
sexSex
date_of_issueDate of issue
date_of_expiryDate of expiry

Macao identity card (2013 version)

FieldDescription
surnameSurname (English)
surname_cnSurname (Chinese)
givennameGiven name (English)
givenname_cnGiven name (Chinese)
id_numberID number
date_of_birthDate of birth
heightHeight
sexSex
date_of_issueDate of issue
date_of_expiryDate of expiry
first_issue_dateDate of first issue

Macao identity card (2002 version)

FieldDescription
nameName (English)
name_cnName (Chinese)
id_numberID number
date_of_birthDate of birth
sexSex
date_of_issueDate of issue
date_of_expiryDate of expiry

Taiwan (China)

Taiwan identity card

Front

FieldDescription
id_numberID number
nameName
date_of_birthDate of birth
sexSex
date_of_issueDate of issue

Back

FieldDescription
father_nameFather's name
mother_nameMother's name
spouse_nameSpouse's name
military_service_typeMilitary service type
place_of_birthPlace of birth
addressResidential address
codeBlank certificate serial control number

Vietnam

Vietnamese identity card (2021 chip version)

FieldDescription
full_nameFull name
id_numberID number
date_of_birthDate of birth
sexSex
nationalityNationality
place_of_originPlace of origin
place_of_residencePlace of residence
date_of_issueDate of issue
date_of_expiryDate of expiry
personal_identificationPersonal identification

Vietnamese e-Passport

FieldDescription
full_nameName
passport_numberPassport number
nationalityNationality
date_of_birthDate of birth
sexSex
id_card_numberID card number
date_of_issueDate of issue
date_of_expiryDate of expiry
place_of_issuePlace of issue
typeType

Malaysia

Malaysian identity card (MyKad)

Front

FieldDescription
id_numberID number
nameName
addressAddress
nationalityNationality
religionReligion
genderSex

Back

FieldDescription
id_number_backID number
snSerial number

Malaysian driver's license

FieldDescription
nameName
nationalityNationality
id_numberID number
license_classLicense class
validity_periodValidity period
addressAddress

Indonesia

Indonesian identity card

FieldDescription
id_numberNational identity number
nameName
place_of_birthPlace of birth
date_of_birthDate of birth
genderSex
addressAddress
rt_rwRT/RW code
villageVillage/Community name
sub_districtSub-district
religionReligion
marital_statusMarital status
occupationOccupation
nationalityNationality
valid_untilValid until

Singapore

Singapore National Registration Identity Card (NRIC)

Page 01

FieldDescription
identity_card_numberID number
nameName
raceRace
date_of_birthDate of birth
sexSex
country_of_birthCountry or region of birth

Page 02

FieldDescription
nric_numberNational Registration Identity Card number
date_of_issueDate of issue
addressAddress
nationalityNationality

Singapore driver's license

FieldDescription
licence_numberID number
nameName
date_of_birthDate of birth
issue_dateDate of issue
valid_tillValid till

Singapore passport

FieldDescription
typeType
country_codeCountry code
passport_numberPassport number
nameName
sexSex
date_of_birthDate of birth
date_of_issueDate of issue
date_of_expiryDate of expiry
nationalityNationality
place_of_birthPlace of birth
authorityIssuing authority
national_id_numberNational ID number

Thailand

Thai identity card

FieldDescription
id_numberID number
surnameSurname (English)
given_namesGiven names (English)
name_thName (Thai)
date_of_birthDate of birth (Gregorian calendar)
date_of_birth_thDate of birth (Thai calendar)
religionReligion
addressAddress
date_of_issueDate of issue (Gregorian calendar)
date_of_issue_thDate of issue (Thai calendar)
date_of_expiryDate of expiry (Gregorian calendar)
date_of_expiry_thDate of expiry (Thai calendar)
qr_numberSerial number

Thai private vehicle driver's license

FieldDescription
licence_numberLicense number
date_of_issueDate of issue
date_of_expiryDate of expiry
nameName
date_of_birthDate of birth
id_numberCitizen ID number
place_of_issuePlace of issue

Thai passport

FieldDescription
typeType
country_codeCountry code
passport_numberPassport number
surnameSurname (English)
given_namesTitle / Given names (English)
name_thName (Thai)
sexSex
date_of_birthDate of birth
date_of_issueDate of issue
date_of_expiryDate of expiry
nationalityNationality
place_of_birthPlace of birth
authorityIssuing authority
national_id_numberNational ID number

Philippines

Philippine identity card

FieldDescription
id_numberNational ID
last_nameLast name
middle_nameMiddle name
given_namesGiven names
date_of_birthDate of birth
addressAddress

Philippine UMID card

FieldDescription
crnCRN code
surnameLast name
given_nameGiven name
middle_nameMiddle name
sexSex
date_of_birthBirthday
addressAddress

Philippine driver's license

FieldDescription
last_nameLast name
first_nameFirst name
middle_nameMiddle name
nationalityNationality
sexSex
date_of_birthDate of birth
addressAddress
license_numberLicense number
expiration_dateDate of expiry
agency_codeIssuing agency code
restrictionsDriving restrictions. Note: These are the DL Codes in the new version of the certificate.
conditionsAdditional driving conditions

Philippine passport

FieldDescription
surnameLast name
given_namesGiven names
middle_nameMiddle name
date_of_birthDate of birth
nationalityNationality
sexSex
place_of_birthPlace of birth
date_of_issueDate of issue
date_of_expiryDate of expiry
passport_numberPassport number
issuing_authorityIssuing authority
country_codeCountry code
typeType

Philippine Social Security System (SSS) certificate

FieldDescription
nameName
date_of_birthDate of birth
id_numberSSS certificate number

Philippine voter's card

FieldDescription
id_numberVoter's ID number
nameName
date_of_birthDate of birth
marital_statusMarital status
nationalityNationality
addressAddress
precinct_numberPrecinct number

Philippine professional identification card

FieldDescription
last_nameLast name
first_nameFirst name
middle_nameMiddle name
registration_numberRegistration number
registration_dateRegistration date
valid_untilValid until
date_of_birthDate of birth
data_of_issueDate of issue
professionProfessional realm

Philippine postal ID

FieldDescription
nameName
addressAddress
date_of_birthDate of birth
nationalityNationality
issuing_post_officeIssuing post office
valid_untilValid until
prnPostal Reference Number (PRN)

Philippine Taxpayer Identification Number (TIN) card

FieldDescription
nameName
tin_numberTaxpayer Identification Number (TIN)
addressAddress
date_of_birthDate of birth
data_of_issueDate of issue

Mexico

Mexican national electoral card

FieldDescription
full_nameFull name
genderSex
addressAddress information
voter_numberVoter number
curpCURP (Unique Population Registry Code)
time_of_registrationYear of registration
date_of_birthDate of birth
constituency_numberConstituency number (optional)
validity_periodValidity period

South Korea

South Korean identity card

FieldDescription
nameName
id_numberID number
addressAddress
date_of_issueDate of issue
origin_of_issueIssuing authority

South Korean driver's license

FieldDescription
licence_numberLicense number
nameName
id_numberResident registration number
addressAddress
date_of_expiryValidity period
encrypted_serial_numberEncrypted serial number
date_of_issueDate of issue
origin_of_issueIssuing authority

South Korean passport

FieldDescription
typePassport type
issuing_countryIssuing country
passport_numberPassport number
surnameSurname (English)
given_namesTitle / Given names (English)
nationalityCountry code
date_of_birthDate of birth
personal_numberNational ID number
sexSex
date_of_issueDate of issue
authorityIssuing authority
date_of_expiryDate of expiry
name_koName (Korean)
mrzMRZ code

Nigeria

Nigerian digital NIN slip

FieldDescription
id_numberID number
surnameLast name
date_of_birthDate of birth
sexSex
date_of_issueDate of issue
nationalityNationality
given_namesGiven names

Bangladesh

Bangladesh identity card

FieldDescription
name_bnName (Bengali)
nameName
name_of_fatherFather's name
name_of_motherMother's name
date_of_birthDate of birth
id_numberID number