Legacy Text Examples - Driver's License Transactions (DQ/DR. DNQ/DNR, DQG/DRG)

Driver's License Legacy Specifications

This section describes Legacy format and provides examples for driver's license transactions.

The following are general specifications for Driver's License queries and responses.

All inquiries and responses are in a fixed format.
All messages are preceded by a standard input header as described in Message Structure.
All data elements are preceded by a prefix and terminated by a period.
The final character of the message should not be a period (conforms to standard NCIC message structure).
Control characters are permitted throughout the text of the message and should be ignored by the queried state when examining the inquiry.
No embedded spaces or special characters (i.e. hyphens) should be in the inquiry.
If a regional code is used, the message type should be DQG. If it is not, Nlets will change it to DQG and handle it at a lower priority.
States receiving a DQG must respond with a DRG.

Query Formats

To send a driver's license query:

Enter the following: DQ. or DQG. Sending ORI followed by a period. Destination ORI followed by a period (up to five 2-character state codes or regional codes; if
a regional code the DQG should be used). If needed, optional control field. TXT CR,LF,DEL (Optional). "RSN/" (Optional) followed by the Reason Code. Enter either: "OLN/" followed by the driver's license number. Not valid for DQG. OR- "NAM/" followed by the name and a period. "DOB/" followed by the complete date of birth and a period. Format: mmddyy or ccyymmdd. "SEX/" followed by the sex code. Only queries on NAM/DOB may be used for a DQG. "IMQ/" followed by a "Y" or "N"; for DQ only, not for DQG.

Note: Nlets also supports inquiries on Driver history information.
The user should recognize the differences between these two types of transactions as described below.

Driver's License transactions and Driver History transactions utilize different message types.
Driver history requests and responses use KQ and KR respectively, while normal driver
license requests utilize DQ/DR.
Although the required information is identical, users requesting driver history with a KQ may
include a purpose code and/or an attention field.
There are no specific response formats for KRs as there are for DRs.
Unlike DQs only a single two character state code may be used as a destination address for KQs.

The format for a driver's license inquiry on name and date of birth is as follows.

Entry # Char. Explanation

DQ.
or
DQG

2 Message type followed by a period. Message Header 13-36

Standard input message header, may include control
field and up to 5 addresses (state or regional codes;
DQG should be used for regionally addressed queries).

TXT 3 Fixed filed prefix to beginning of message. CR,LF,DEL 3 Control characters (optional). RSN/ 1 Prefix to identify a Reason Code. Reason Code (Optional) 1

Reason Code; Valid values are: N, F, V, T, S, H or I.

NAM/ 4 Prefix to identify name. Name Max. 30

Full name; format is last name, comma, space after
comma is optional) first name, space, middle initial or
name, space, suffix (Jr., III, etc.) Followed by a period.
Titles or degrees should not be used as part of the
name.

DOB/ 4 Prefix to identify date of birth. Date of Birth 6

Date of Birth followed by a period. Express as mmddyy
or ccyymmdd. Complete DOB must be present. Some
states have different requirements. Check their OLN
HELP file for details.

SEX/ 4 Prefix to identify sex. Sex 1 Sex; conforms to NCIC codes. IMQ/ 4 (For XML use only) Prefix to identify image request field. Image Request 1 Y to request driver photo; use N if no image is wanted
or omit IMQ/ field.

The format for a driver's license inquiry or driver's license number is:

Entry # Char. Explanation DQ. 3 Message type followed by a period. Message Header 13-36 Standard input message header may include control field. TXT 3 Fixed filed prefix to beginning of message. CR,LF,DEL 3 Control characters (optional). RSN/ 1 Prefix to identify a Reason Code. Reason Code (Optional) 1

Reason Code; Valid values are: N, F, V, T, S, H or I.

OLN/ 4 Prefix to identify driver license number. Driver's Lic. # 1-20 Driver license number. IMQ/ 4 (For XML use only) Prefix to identify image request field. Image Request 1 Y to request driver photo; use N if no image is wanted
or omit IMQ/ field.

Response Formats

Should the information be unavailable, or, after interrogation of the state files, no information is found, a standard response message is returned.
If a data field is unavailable, the prefix, data element, and period should be omitted from the response.
The message should be compacted to eliminate the resultant spaces.

Note: Inquiries on name may result in multiple hits. Only close matches (i.e., exact match on
last name and DOB) should be returned. When multiple hits do occur, they should be
returned as separate messages.

Note: All responses to DNQ inquiries must have a message type of DNR.

Note: "NOT ON FILE", "FILE NOT AVAILABLE" and "TEMPORARILY UNAVAILABLE"
messages will be followed by either the driver's name or driver's license number upon which
the query was based.

Driver's License by Name Only General Specifications (DNQ)

To send a Driver's License by Name Only Query (DNQ) enter the following.

Enter: DNQ. Sending ORI followed by a period Destination ORI followed by a period (only one 2-character state code) If needed, optional control field TXT CR,LF,DEL (Optional) "RSN/" (Optional) followed by the Reason Code Then enter: "NAM/" followed by, at minimum, the last, first name And any of these optional fields: "AGE/" followed by the age "SEX/" followed by the sex "CTY/" followed by city, town or village of subject "COU/" followed by the county where the subject lives "NXT/" followed by special codes or numbers to request the next screen or page.

Obtain this information from the state's HELP file.

The format for a driver's license inquiry (DNQ) when a complete date of birth is not known is presented below.

Note that the message key is different than a normal driver license query.

Entry # Char. Explanation DNQ. 3 Message type followed by a period. Message Header 13-24 Standard input message header, may include control field
but only a single 2 character state code. TXT 3 Fixed filed prefix to beginning of message. CR,LF,DEL 3 Control characters (optional). RSN/ 1 Prefix to identify a Reason Code. Reason Code (Optional) 1

Reason Code; Valid values are: N, F, V, T, S, H or I.

NAM/ 4 Prefix to identify name. Name Max. 30

This field must include at least a first and last name in the
standard name format (surname, first name). Some
states allow a question mark "?" in the surname if the full
surname is not known. Consult state help files to
determine if a state can support this capability. (E.g.,
NAM/PUBL?, JOHN Q.).

AGE/ (optional) 4 Prefix to identify age. Age 2

Age followed by a period. If a complete date of birth is
known a DQ should be used. Some states may handle
age differently than others. Consult their HELP file for
details. The address is xxOLNHELP where xx=2
character state code.

SEX/ (optional) 4 Prefix to identify sex. Sex 1 Sex; conforms to NCIC codes. CTY/ (optional) 4 Prefix to identify city, village or town where subject lives. City 20 City, village or town where subject lives. COU/ (optional) 4 Prefix to identify county. County 20 County where subject lives. NXT/ (optional) 4 Prefix to identify the Next field. Next page or group 20

A free form field used to request additional pages.
Individual state HELP files will dictate if this field is used
and what it must contain.

Driver's License by Name Only Response Format (DNR)

All responses to DNQ inquiries must have a message type of "DNR" but otherwise are identical to DQ responses (DR).

States must use the "DNR" message type for responses to DNQ messages.

The free form fields "RSTR:" and "STATUS:" are for the states to indicate restrictions on an individual when operating his vehicle (i.e. corrective lenses) and the status of the individual's license (i.e. revoked), respectively.

Information should be confined to short, concise, plain English messages.

Driver's License Legacy Examples

Example 1: A Driver License query by name, date of birth and sex.

DQ.AZNLETS20.AZ.TXT
NAM/SMITH,JOHN.DOB/19500101.SEX/M

Example 2: A Driver License query by OLN.

DQ.AZNLETS20.AZ.TXT
OLN/111111111

Example 3: A Driver License query by name, date of birth and sex with optional Reason Code.

DQ.AZNLETS20.AZ.TXT
RSN/T.NAM/SMITH,JOHN.DOB/19500101.SEX/M

Example 4: A Driver License query by OLN with optional Reason Code.

DQ.AZNLETS20.AZ.TXT
RSN/T.OLN/111111111

Example 5: A Driver License response.

DR.AZDMV0000
11:08 10/07/2011 00248
11:08 10/07/2011 00052 AZNLETS20
TXT
Query data:
OLN/111111111.IMQ/N.
NAME: SMITH, JOHN
RESIDENCE ADDRESS: 1234 ANYSTREET; PHOENIX,AZ 85000
COUNTRY: United States
DATE OF BIRTH: 1950-01-01
HEIGHT: 507
WEIGHT: 150
GENDER: MALE
RACE: UNKNOWN
*** DRIVER LICENSE DETAILS ***
DRIVER AUTHORIZATION ID: 111111111
JURISDICTION AUTHORITY CODE: AZ
ISSUE DATE: 2009-01-10
EXPIRATION DATE: 2045-01-10
DRIVER ENDORSEMENT: MOTORCYCLE
DRIVING ENDORSMENT CODE: M
DRIVER LICENSE NON-COMMERCIAL CLASS: LICENSE
DRIVER LICENSE NON-COMMERCIAL CLASS CODE: C
LICENSED COMMERCIAL DRIVER: NO
LICENSED NON-COMMERCIAL DRIVER: YES
DRIVER LICENSE NON-COMMERCIAL STATUS: VALID OPERATORS LICENSE
DRIVER ORGAN DONOR: true

Example 6: A Driver License query by Region. The response will be a standard Driver License response (DR).

DQG.AZNLETS20.A1.TXT
NAM/SMITH,JOHN.DOB/19500101.SEX/M

Example 7: A Driver License query by name.

DNQ.AZNLETS20.AZ.TXT
NAM/SMITH,JOHN

Example 8: A Driver License query by Region with optional Reason Code. The response will be a standard Driver License response (DR).

DQG.AZNLETS20.A1.TXT
RSN/T.NAM/SMITH,JOHN.DOB/19500101.SEX/M

Example 9: A Driver License query by name with optional Reason Code.

DNQ.AZNLETS20.AZ.TXT
RSN/T.NAM/SMITH,JOHN

Example 10: A Driver License response by name.

DNR.AZDMV0000
08:10 10/11/2011 79931
08:10 10/11/2011 00711 AZNLETS20
TXT
JOHN SMITH
RESIDENCE ADDRESS: 1234 ANY STREET; PHOENIX,AZ 85000
COUNTRY: UNITED STATES
COUNTY: MARICOPA
LOCATION COUNTY: MARICOPA
RACE: Black
GENDER: Male
DATE OF BIRTH: 1950-01-01
DRIVER AUTHORIZATION ID: 12345

JOHN SMITH
RESIDENCE ADDRESS: 2345 THAT PLACE; GLENDALE,AZ 85000
COUNTRY: UNITED STATES
COUNTY: MARICOPA
LOCATION COUNTY: MARICOPA
RACE: White
GENDER: Male
DATE OF BIRTH: 1951-01-01
DRIVER AUTHORIZATION ID: 23456

JOHN SMITH
RESIDENCE ADDRESS: 3456 SOME DRIVE; PEORIA,AZ 85000
COUNTRY: UNITED STATES
COUNTY: MARICOPA
LOCATION COUNTY: MARICOPA
RACE: Black
GENDER: Male
DATE OF BIRTH: 1952-01-01
DRIVER AUTHORIZATION ID: 34567

JOHN SMITH
RESIDENCE ADDRESS: 4567 THIS AVENUE; PHOENIX,AZ 85000
COUNTRY: UNITED STATES
COUNTY: MARICOPA
LOCATION COUNTY: MARICOPA
GENDER: Unknown
DATE OF BIRTH: 1901-01-01
DRIVER AUTHORIZATION ID: 45678