ID Parsing Library for .NET

DL/ID Parsing Library

DL/ID cards are widely used for storing personal information such as first name, last name, birth date, address, etc. They also contain special information related to driving activity including DL number, class and restrictions. Because of the utility of this data, there is a high demand for mobile applications that can scan and process DL/ID information.

Magnetic Stripe and 2D formats greatly vary from one state to another, causing numerous difficulties when attempting to parse information encoded in each DL. For instance, some cards may contain tracks in the inverted order, while others may use slightly shifted track positions for storing fields.

As a solution, IDScan.net developed a DL/ID Parsing library for multiple development environments. The whole list can be found on our download page. We collected 10+ years of ID formats from the US, Canada, and many other countries and tested each one to ensure every DL/ID card is parsed with precision.

Implementation Instructions Using Microsoft Visual Studio

for .NET languages

  1. Download dlplib from the link below and extract files.
  2. With your project open, go to Project -> Add Reference and browse path to dlplib.dll.

SC1 SC2

Example projects can found below or on our SDK downloads here.

.NET ID Parsing Library – Download

C# Example Project for SDK Lite (Hardware ID and Registration Key) – Download

VB.NET Example Project for SDK Lite (Hardware ID and Registration Key) – Download

.NET Library Properties, Methods, Events

DriverLicense Class

Object that enables access to parsed information from an ID.

Constructors

NameDescription
DriverLicense()Initializes an instance of the DriverLicense class

Fields

Field NameDescription
FullNameFull name of cardholder
Address1First line of address of cardholder
Address2Second line of address of cardholder
CityCity of cardholder address
JurisdictionCodeState of cardholder address
CountryCountry of cardholder
PostalCode
Postal code of cardholder address, if unknown, zeroes will be used
BirthDateBirth date of cardholder
GenderGender of cardholder
HeightHeight of cardholder, followed by “in” or “cm”
ExpirationDateDate on which the driving and identification privileges granted by the document are no longer valid (MMDDCCYY for U.S.)
EyeColorColor of cardholder’s eyes, as defined in ANSI D-20 codes
LicenseNumberLicense number of cardholder
DocumentTypeCan be a driver’s license or ID
ID – Identity Card
DL – Driver License
CC – Bank Card
HC – Health Card
TD – Machine Readable Travel Document
CAC – Department of Defense and Common Access Card
HairColorHair color of cardholder. Brown, black, blonde, gray, red/auburn, sandy, white
IIN
Issuer Identification Number – the full 6-digit IIN should be encoded
IssueDateIssue date of DL/ID
NamePrefixNamePrefix of cardholder
NameSuffixNameSuffix of cardholder
RaceRace or ethnicity of cardholder as defined in ANSI D20
SpecificationStandard of scanned document
WeightKGPhysical weight or weight range in KG.
ex.
77
up to 31
32 – 45
46 – 59
WeightLBSPhysical weight or weight range in pounds.
ex.
138
up to 70
71 – 100
101 – 130
ComputerIDHardware ID
ClassificationCodeDriver License classification code as defined by Federal Highway regulations and by AAMVA; others are defined by DL Classification Code Standards
RestrictionCodeDriver License restriction code that curtail driving privileges
VehicleClassCodeJurisdiction-specific vehicle class / group code, designating the type of vehicle the cardholder has privilege to drive
EndorsementsCodeAny endorsements on a driver license which authorize the operation of specified types of vehicles or the operation of vehicles carrying specified loads. Endorsements shall be specific to classification of a driver license

Methods

Method NameDescriptionReturn Value
ParseText(System.String)
Parses scanned text of IDReturns a DriverLicense object on success and null on error
ExtractInfo(System.String)
Extracts information from scanned driver’s license or ID. This is a deprecated method, should be utilized only in such cases when a static call cannot be used
Returns true on success and false on error

DriverLicenseEx Class

This class is similar to DriverLicense but also provides support for data types such as date, boolean, string, etc and does not contain an ExtractInfo() method.

NameDescription
DriverLicenseEx()Initializes an instance of the DriverLicenseEx class

Fields are the same as DriverLicense.

Methods

Method NameDescriptionReturn Value
ParseText(System.String)
Parses scanned text of ID.Returns a DriverLicense object on success and null on error