United States (US) DPV Attributes

This is a complete list of all attributes and descriptions for the US Postal Matcher's DPV options.

Note: As of v15.5, when running the US Postal Matcher in callable mode (API), only the us_dpv_confrm and us_dpv_cmra attributes are returned and no other attributes are returned, due to license agreement with the USPS.

Attribute

Length

Description

us_dpv_confirm

1

Attribute to store the DPV CONFIRM value. Generates one of the following characters:

Y—Input record is a valid mailing address listed in the DPV database.

N—Input record is not in the DPV database of valid mailing addresses.

S—Secondary address (apartment or rural route box number) is not valid, although the primary address (house number or rural route) validates.

D—Input record is a valid mailing address, but is missing the secondary address (apartment or rural route box number).

V—A violation occurred.

Note: If this attribute is empty, the input address was not matched to the ZIP+4 database.

us_dpv_cmra

1

Attribute to store the DPV CMRA value. Generates one of the following characters:

Y—Input record is the address of a Commercial Mail Receiving Agency (CMRA), such as Mail Boxes Etc.

N—Input record is not a CMRA address.

V—A violation occurred.

Note: If this attribute is empty, the input address was not presented to the violation hash table.

us_dpv_violation

1

Attribute to store the DPV violation value. Generates one of the following codes:

Y—Input record appears to be a synthetic address and caused a violation. As required by the US Postal Service, DPV processing terminates and DPV output attributes will generate only V until DPV processing is re-enabled with the Unlock DPV code.

N—Input record is not in the DPV database.

V—A violation occurred.

Note: If this attribute is empty, the input address was not presented to the violation hash table.

us_dpv_footnote1

2

Attribute to store the DPV FOOTNOTE1 value. Generates a string that contains one of the following two-character standard Postal Service codes:

AA—Input address matched the ZIP+4 file.

A1—Input address did not match the ZIP+4 file.

Note: If this attribute is empty, other DPV output attributes such as "DPV CMRA", "DPV confirm", or "DPV violation" are generating V codes.

us_dpv_footnote2

2

Attribute to store the DPV FOOTNOTE2 value. Generates a string that contains one of the following two-character standard Postal Service codes:

Note: Primary means a house number or rural route, secondary means an apartment or rural route box number.

BB—Input address matched the DPV file.

CC—Input address primary matched DPV but the secondary did not match.

F1—Military address.

G1—General Delivery.

N1—Input address matched a DPV high-rise but secondary was not input.

M1—Input address primary is missing.

M3—Input address primary is invalid.

P1—Input address is missing a PO box, rural route, or highway contract box number.

U1—Unique ZIP code.

Note: If this attribute is empty, then other DPV output attributes (for example, DPV CMRA, DPV confirm, or DPV violation) are generating V codes, or were not presented to the DPV hash tables.

us_dpv_footnote3

2

Generates a string that contains one of the following two-character standard Postal Service codes:

RR—Input address matched a CMRA.

R1—Input address matched a CMRA but a secondary was not input.

PB—Input address matched PBSA table.

us_dpv_nostat

1

Attribute to store DPV NoStat flag (address is currently not receiving deliveries):

Y—Address was found in NOSTAT table.

N—Address was not found in NOSTAT table.

Blank—Not checked against NOSTAT table.
us_dpv_pbsa 1

Attribute to store DPV PBSA flag:

Y—Address was found in PBSA table.

N—Address was not found in PBSA table.

Blank—Not checked against PBSA table.

us_dpv_vacant

1

Attribute to store DPV VACANT flag:

Y—Address was found in VACANT table.

N—Address was not found in VACANT table.

Blank—Not checked against VACANT table.