aamva-parser

Parse AAMVA PDF417 barcode data from US and Canadian driver's licenses and ID cards. TypeScript-ready, zero dependencies.

Features

• Supports AAMVA versions 1-12 (CDS 2000-2025)
• Zero dependencies
• TypeScript-ready with full type definitions
• ESM and CommonJS support
• Built-in helpers for age verification, name formatting, and CDL detection
• Parses 30+ fields including name, address, dates, and physical descriptors

Table of Contents

• Installation
• Usage
• API
• Supported Fields
• AAMVA Version Support
• Example
• AAMVA Element IDs by Version
• Contributing
• License
• Credits

Requirements

• Node.js >= 20

Installation

npm install aamva-parser

Usage

ES Modules

import { parse, isExpired, getVersion, getAge, isUnder21, getFullName } from "aamva-parser";

// Parse the PDF417 barcode data
const license = parse(barcodeData);

console.log(license.firstName);    // "JOHN"
console.log(license.lastName);     // "PUBLIC"
console.log(license.dateOfBirth);  // Date object
console.log(license.expirationDate); // Date object
console.log(license.expired);      // false

// Quick helpers
const age = getAge(barcodeData);        // 56
const under21 = isUnder21(barcodeData); // false
const name = getFullName(barcodeData);  // "JOHN QUINCY PUBLIC"

// Check if license is expired
const expired = isExpired(barcodeData); // boolean

// Get AAMVA version
const version = getVersion(barcodeData); // "08"

CommonJS

const { parse, isExpired, getVersion } = require("aamva-parser");

const license = parse(barcodeData);

TypeScript

import {
  parse,
  ParsedLicense,
  Gender,
  EyeColor
} from "aamva-parser";

const license: ParsedLicense = parse(barcodeData);

if (license.gender === Gender.Male) {
  console.log("Male");
}

if (license.eyeColor === EyeColor.Brown) {
  console.log("Brown eyes");
}

API

All helper functions accept raw barcode data as a string.

Function	Returns	Description
parse(data)	ParsedLicense	Parses the raw PDF417 barcode string and returns all extracted fields
getVersion(data)	string | null	AAMVA version number (e.g., "08")
isExpired(data)	boolean	true if the expiration date has passed
getAge(data)	number | null	Age in years from date of birth
isUnder21(data)	boolean	true if under 21
isUnder18(data)	boolean	true if under 18
isAcceptable(data)	boolean	true if not expired, has been issued, and contains all required fields
getFullName(data)	string | null	Full name as "FIRST MIDDLE LAST"
getState(data)	string | null	State/jurisdiction code (e.g., "CA")
isCDL(data)	boolean	true if Commercial Driver's License (v12/CDS 2025 only)

Deprecated Functions

The following PascalCase functions still work but are deprecated. Use the camelCase versions instead:

Deprecated	Use Instead
Parse()	parse()
GetVersion()	getVersion()
IsExpired()	isExpired()

Supported Fields

Field	Type	Attribute
First Name	string	firstName
Last Name	string	lastName
Middle Name	string	middleName
Expiration Date	Date	expirationDate
Issue Date	Date	issueDate
Date of Birth	Date	dateOfBirth
Gender	Gender	gender
Eye Color	EyeColor	eyeColor
Hair Color	HairColor	hairColor
Height (inches)	number	height
Weight (lbs)	string	weight
Street Address	string	streetAddress
Street Address Line 2	string	streetAddressSupplement
City	string	city
State	string	state
Postal Code	string	postalCode
Driver's License ID	string	driversLicenseId
Document ID	string	documentId
Issuing Country	IssuingCountry	country
Name Suffix	NameSuffix	suffix
First Name Truncation	Truncation	firstNameTruncation
Middle Name Truncation	Truncation	middleNameTruncation
Last Name Truncation	Truncation	lastNameTruncation
Place of Birth	string	placeOfBirth
Audit Information	string	auditInformation
Inventory Control Number	string	inventoryControlNumber
First Name Alias	string	firstNameAlias
Last Name Alias	string	lastNameAlias
Suffix Alias	string	suffixAlias
CDL Indicator	string	cdlIndicator
Non-Domiciled Indicator	string	nonDomiciledIndicator
Enhanced Credential Indicator	string	enhancedCredentialIndicator
Permit Indicator	string	permitIndicator
Is Expired	boolean	expired
AAMVA Version	string	version
Raw Barcode Data	string	pdf417

AAMVA Version Support

CDS Version	Year	Barcode Version	Supported
2000	2000	01	Yes
2003	2003	02	Yes
2005	2005	03	Yes
2009	2009	04-05	Yes
2010	2010	06	Yes
2011	2011	07	Yes
2012	2012	08	Yes
2013	2013	09	Yes
2016	2016	10	Yes
2020	2020	11	Yes
2025	2025	12	Yes

Example

Raw PDF417 Barcode Data (Version 8)

@

ANSI 636026080102DL00410288ZA03290015DLDAQD12345678
DCSPUBLIC
DDEN
DACJOHN
DDFN
DADQUINCY
DDGN
DCAD
DCBNONE
DCDNONE
DBD08242015
DBB01311970
DBA01312035
DBC1
DAU069 in
DAYGRN
DAG789 E OAK ST
DAIANYTOWN
DAJCA
DAK902230000
DCF83D9BN217QO983B1
DCGUSA
DAW180
DAZBRO
DCK12345678900000000000
DDB02142014
DDK1
ZAZAAN
ZAB
ZAC

Parsed Result

{
  firstName: "JOHN",
  lastName: "PUBLIC",
  middleName: "QUINCY",
  dateOfBirth: Date("1970-01-31"),
  expirationDate: Date("2035-01-31"),
  issueDate: Date("2015-08-24"),
  gender: "Male",
  eyeColor: "Green",
  hairColor: "Brown",
  height: 69,
  weight: "180",
  streetAddress: "789 E OAK ST",
  city: "ANYTOWN",
  state: "CA",
  postalCode: "902230000",
  driversLicenseId: "D12345678",
  documentId: "83D9BN217QO983B1",
  country: "United States",
  inventoryControlNumber: "12345678900000000000",
  expired: false,
  version: "08"
}

AAMVA Element IDs by Version

Bold = Mandatory field | -- = Not included in version

Field	v1	v2	v3	v4	v5	v6	v7	v8	v9	v10	v11	v12
First Name	DAC	DCT	DCT	DAC	DAC	DAC	DAC	DAC	DAC	DAC	DAC	DAC
Last Name	DAB	DCS	DCS	DCS	DCS	DCS	DCS	DCS	DCS	DCS	DCS	DCS
Middle Name	DAD	DAD	DAD	DAD	DAD	DAD	DAD	DAD	DAD	DAD	DAD	DAD
Expiration Date	DBA	DBA	DBA	DBA	DBA	DBA	DBA	DBA	DBA	DBA	DBA	DBA
Issue Date	DBD	DBD	DBD	DBD	DBD	DBD	DBD	DBD	DBD	DBD	DBD	DBD
Date of Birth	DBB	DBB	DBB	DBB	DBB	DBB	DBB	DBB	DBB	DBB	DBB	DBB
Gender	DBC	DBC	DBC	DBC	DBC	DBC	DBC	DBC	DBC	DBC	DBC	DBC
Eye Color	DAY	DAY	DAY	DAY	DAY	DAY	DAY	DAY	DAY	DAY	DAY	DAY
Height	DAU	DAU	DAU	DAU	DAU	DAU	DAU	DAU	DAU	DAU	DAU	DAU
Street Address	DAG	DAG	DAG	DAG	DAG	DAG	DAG	DAG	DAG	DAG	DAG	DAG
City	DAI	DAI	DAI	DAI	DAI	DAI	DAI	DAI	DAI	DAI	DAI	DAI
State	DAJ	DAJ	DAJ	DAJ	DAJ	DAJ	DAJ	DAJ	DAJ	DAJ	DAJ	DAJ
Postal Code	DAK	DAK	DAK	DAK	DAK	DAK	DAK	DAK	DAK	DAK	DAK	DAK
License ID	DBJ	DAQ	DAQ	DAQ	DAQ	DAQ	DAQ	DAQ	DAQ	DAQ	DAQ	DAQ
Document ID	--	DCF	DCF	DCF	DCF	DCF	DCF	DCF	DCF	DCF	DCF	DCF
Country	--	DCG	DCG	DCG	DCG	DCG	DCG	DCG	DCG	DCG	DCG	DCG
Weight	--	DAW	DAW	DAW	DAW	DAW	DAW	DAW	DAW	DAW	DAW	DAW
CDL Indicator	--	--	--	--	--	--	--	--	--	--	--	DDM
Non-Domiciled Indicator	--	--	--	--	--	--	--	--	--	--	--	DDN
Enhanced Credential	--	--	--	--	--	--	--	--	--	--	--	DDO
Permit Indicator	--	--	--	--	--	--	--	--	--	--	--	DDP

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT

Credits

Inspired by the Swift version at ksoftllc/license-parser.