ID type: driver license/ID card
Fields returned for the United States driver licenses are displayed above the blank row in the following table. Fields that will return no information are displayed below the blank row. 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 MM-dd-yyyy on the card will return the data in the format 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, B**, F/B | Parses the address into Address, City, State, and Zip, according to regional rules. | |
| Address2 | F, B**, 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, B**, 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 | N/A | No validation rule | |
| Address5 | N/A | No validation rule | |
| Address6 | N/A | No validation rule | |
| City | F, B**, F/B | Parses the address into Address, City, State, and Zip, according to regional rules. | |
| Class | F, B**, F/B | No validation rule. | |
| Country | F, B**, F/B | Validates the string against the constant value United States. | |
| CountryShort | F, B**, F/B | Validates the string against the constant value USA. | |
| DDRef***** | F, B**, F/B | No validation rule | |
| DateOfBirth | F, B**, F/B | YYYY-MM-DD | Validates the string against the format [MM-dd-yyyy, MM/dd/yyyy, MM-dd-yy]. |
| DocumentState | F, B**, F/B | Validates the string against the constant value [Alabama, Alaska, Arizona, Arkansas, California, Colorado, Connecticut, Delaware, Washington D.C., Florida, Georgia, Hawaii, Idaho, Illinois, Indiana, Iowa, Kansas, Kentucky, Louisiana, Maine, Maryland, Massachusetts, Michigan, Minnesota, Mississippi, Missouri, Montana, Nebraska, Nevada, New Hampshire, New Jersey, New Mexico, New York, North Carolina, North Dakota, Ohio, Oklahoma, Oregon, Pennsylvania, Rhode Island, South Carolina, South Dakota, Tennessee, Texas, Utah, Vermont, Virginia, Washington, West Virginia, Wisconsin, Wyoming]. | |
| DocumentType | F, B**, F/B | Validates the string against the constant value [DL, ID] | |
| ExpirationDate | F, B**, F/B | YYYY-MM-DD | Validates the string against the format [MM-dd-yyyy, MM/dd/yyyy, MM-dd-yy]. |
| Eyes* | F, B**, F/B | No validation rule. | |
| FirstName | F, B**, F/B | Parses the name into the fields: FirstName, MiddleName, LastName, and NameSuffix. | |
| Gender | F, B**, F/B | M, F | Validates the string against the values [M,F]. Will also force a match of [Male, M] to M and [Female, F] to F. |
| Hair*** | F, B**, F/B | No validation rule | |
| Height | F, B**, F/B | Ft-in [1-11, 1-01] | Validates the string against the format [1'11, 1'11'', 1'1, 1'1'', 1-11, 1-1, 1'-11, 1'-11'', 11, 111, 1 11, 11 in, 1FT 1IN, 1FT 11IN, 1 FT 1 IN, 1 FT 11 IN, 111 in]. |
| IDNumber | F, B**, F/B | Delimiters removed | Validates the string against the format [1111111, A111111, 111111111, A11111111, A1111111, 11-111-1111, 111111,
A111-111-11-111-1, 111AA1111, AA111111A, 1111-1111-111A, A111-1111-1111, 1111-11-1111, A11-11-1111, A11-111-111, A-111-111-111-111,
A 111 111 111 111, A111111111111, A111111111, 1111111111111, 11111111, AAA-11-1111, 11AAA11111, A1111 11111 11111, 1111111111, 111
111 111, AA111111, A111111111, 11 111 111, A111-1111-1111-11, 111111-111, 11-1111111].
No validation rule. |
| IssueDate | F, B**, F/B | YYYY-MM-DD | Validates the string against the format [MM-dd-yyyy, MM/dd/yyyy, MM-dd-yy]. |
| LastName | F, B**, F/B | Parses the name into the fields: FirstName, MiddleName, LastName, and NameSuffix. | |
| License | F, B**, F/B | Delimiters removed | Copies the value of IDNumber. |
| MiddleName | F, B**, F/B | Parses the name into the fields: FirstName, MiddleName, LastName, and NameSuffix. | |
| NameSuffix | F, B**, F/B | Parses the name into the fields: FirstName, MiddleName, LastName, and NameSuffix. | |
| Nationality | N/A | No validation rule | |
| State | F, B**, F/B | Validates the string against the constant value [AL, AK, AZ, AR, CA, CO, CT, DE, DC, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY] Parses the address into Address, City, State, and Zip, according to regional rules. | |
| Weight**** | F, B**, F/B | 111 lb, 11 lb, Category 1 | Validates the string against the format [111, 11, 1]. |
| ZIP | F, B**, F/B | Parses the address into Address, City, State, and Zip, according to regional rules. |
** If a readable PDF417 bar code is present. In variants where the bar code is encrypted and data cannot be extracted, data is read from the front. The following IDs have encrypted barcodes:
-
Georgia driver license 2007
-
Illinois driver license 2000, 2005, 2007
-
North Carolina driver license 2000, 2004, 2008
***Present on AK, AZ, CA, ID, IN, ME, NV, NH, NJ, NC, OH, RI, UT, WI
****Not present on AR, CT, FL, IA, KY, MA, NE, NY, NC, ND, PA, TN, TX, VA
*****Returned for New York 2013 version only.