ID type: resident permit
Fields returned for the Taiwan resident permit are displayed in the following table. Fields that will return no information are displayed below the blank line. An "F" denotes that the field will be returned if the front of the card is sent, a "B" denotes that the field will be returned if the back of the card is sent, and "F/B" denotes that the field will be returned if the front and back of the card are sent.
The "Returned as" column shows the normalized format the data will be returned as. A "DateOfBirth" that is formatted as dd-mm-yyyy on the card will return the data in the YYYY-MM-DD for the "DateOfBirth" field according to the rules in the following table, for example.
Some fields are validated against certain rules. Not all fields have validation rules. For fields that have a validation rule, a description of the rule will be included in the "Validation Rules" column. In the "Returned as" and "Validation Rules" columns, a capital "A" denotes any letter, a "1" denotes any number, a "?" can either be a letter or a number, and any other symbol, such as a hyphen, used is literal.
| Field | Side | Returned As | Validation Rule |
|---|---|---|---|
| Address | F, F/B | Parses the address into Address, City, State, and Zip, according to regional rules | |
| Address2 | F, F/B | Parses the address into Address, City, State, and Zip, according to regional rules. Where applicable, each line of the Address field is also parsed into a separate field. This field will contain the first line from the Address field. | |
| Address3 | F, F/B | Parses the address into Address, City, State, and Zip, according to regional rules. Where applicable, each line of the Address field is also parsed into a separate field. This field will contain the second line from the Address field. | |
| Address4 | F, F/B | Parses the address into Address, City, State, and Zip, according to regional rules. Where applicable, each line of the Address field is also parsed into a separate field. This field will contain the third line from the Address field. | |
| Address5 | F, F/B | Parses the address into Address, City, State, and Zip, according to regional rules. Where applicable, each line of the Address field is also parsed into a separate field. This field will contain the fourth line from the Address field. | |
| Address6 | F, F/B | Parses the address into Address, City, State, and Zip, according to regional rules. Where applicable, each line of the Address field is also parsed into a separate field. This field will contain the fifth line from the Address field. | |
| AliasName | N/A | No validation rule | |
| BloodType | N/A | No validation rule | |
| City | F, F/B | Parses the address into Address, City, State, and Zip, according to regional rules. Where applicable, each line of the Address field is also parsed into a separate field. This field will contain the fifth line from the Address field. | |
| Class | N/A | No validation rule | |
| Country | F, B, F/B | Validates the string against the constant value "Taiwan" | |
| CountryShort | F, B, F/B | Validates the string against the constant value "TWN" | |
| DateOfBirth | F, B, F/B | YYYY-MM-DD | Validates the string against the format "yyyy/MM/dd" |
| DateOfBirthLocal | N/A | No validation rule | |
| District | N/A | No validation rule | |
| DocumentState | F, B, F/B | Validates the string against the constant value "Taiwan" | |
| DocumentSubtype | N/A | No validation rule | |
| DocumentType | F, B, F/B | Validates the string against the constant value "Residence Permit" | |
| Employer | N/A | No validation rule | |
| ExpirationDate | F, B, F/B | YYYY-MM-DD | Validates the string against the format "yyyy/MM/dd" |
| Eyes | N/A | No validation rule | |
| FirstName | F, B, F/B | Parses the name into the fields: FirstName, MiddleName, and LastName | |
| FirstNameLocal | N/A | No validation rule | |
| FullName | F, B, F/B | Parses the name into the fields: FullName | |
| FullNameLocal | N/A | No validation rule | |
| Gender | F, B, F/B | M, F | Validates the string against the values [Male, Female] and will also force a match of [Male] to M and [Female] to F. |
| GenderLocal | F, F/B | 男, 女 | Validates the string against the values [Male, Female] and will also force a match of [Male] to 男 and [Female] to 女. |
| Hair | N/A | No validation rule | |
| Height | N/A | No validation rule | |
| IDNumber | F, B, F/B | Validates the string against the format "111111111" | |
| IDNumberLocal | N/A | No validation rule | |
| IssueDate | F, F/B | YYYY-MM-DD | Validates the string against the format "yyyy/MM/dd" |
| IssueDateLocal | N/A | No validation rule | |
| IssuingAuthority | F, F/B | Use as extracted | |
| LastName | F, B, F/B | Parses the name into the fields: FirstName, MiddleName, and LastName | |
| LastNameLocal | N/A | No validation rule | |
| License | F, B, F/B | Validates the string against the format "AA11111111" | |
| LicenseLocal | N/A | No validation rule | |
| MiddleName | F, B, F/B | Parses the name into the fields: FirstName, MiddleName, and LastName | |
| MiddleNameLocal | N/A | No validation rule | |
| MRZ1 | B, F/B | Parses the values of the MRZ according to MRZ standard laid out in ICAO Document 9303: CountryShort, FirstName, MiddleName, LastName, IDNumber, DateOfBirth, Gender, ExpirationDate, Nationality, and License. | |
| MRZ2 | B, F/B | Parses the values of the MRZ according to MRZ standard laid out in ICAO Document 9303: CountryShort, FirstName, MiddleName, LastName, IDNumber, DateOfBirth, Gender, ExpirationDate, Nationality, and License. | |
| MRZ3 | B, F/B | Parses the values of the MRZ according to MRZ standard laid out in ICAO Document 9303: CountryShort, FirstName, MiddleName, LastName, IDNumber, DateOfBirth, Gender, ExpirationDate, Nationality, and License. | |
| NameSuffix | N/A | No validation rule | |
| Nationality | B, F/B | No validation rule | |
| NationalityLocal | F, F/B | Use as extracted | |
| NationalityShort | B, F/B | No validation rule | |
| Occupation | N/A | No validation rule | |
| Photo | F, F/B | Use as extracted | |
| PlaceOfBirth | N/A | No validation rule | |
| PlaceOfIssue | N/A | No validation rule | |
| Race | N/A | No validation rule | |
| SDWOf | N/A | No validation rule | |
| Signature | N/A | No validation rule | |
| State | F, F/B | Parses the address into Address, City, State, and Zip, according to regional rules. Where applicable, each line of the Address field is also parsed into a separate field. This field will contain the second line from the Address field. | |
| SubDistrict | N/A | No validation rule | |
| ValidFrom | N/A | No validation rule | |
| VillageTownCity | N/A | No validation rule | |
| Weight | N/A | No validation rule | |
| ZIP | F, F/B | Parses the address into Address, City, State, and Zip, according to regional rules. Where applicable, each line of the Address field is also parsed into a separate field. This field will contain the second line from the Address field. |