Posts Tagged ‘Corrections’

DOTS Address Validation – US 3: Delivery Point Validation Explained

One of the features of our DOTS Address Validation – US 3 service is Delivery Point Validation, or DPV for short. DPV codes help you determine whether an address is recognized as deliverable by the USPS. But what do these codes mean? This article will explain it all to you.

When we validate an address with Address Validation – US, we tell you if it is a valid mailing address, but we also give you more details than merely a thumbs up or thumbs down. For example, what if the address is close to correct but has a typo, or is missing an apartment or unit number? Correctable problems like these often exist with addresses that are otherwise mailable and deliverable.

Delivery Point Validation codes explained

Delivery Point Validation codes use a value from 1-4 to indicate to what extent the address is recognized as deliverable by the USPS.

“DPV”:”1″

A DPV value of 1 is a thumbs up on the address. In other words, the input address was either a valid USPS recognized mailing address, or could be corrected by us to become a deliverable, recognized mailing address. In many cases, we can clean up an address, by fixing typos and/or deducing data points such as city, state or zip code, to achieve a DPV score of 1.

Below are some examples that will produce a Delivery Point Validation score of 1.


Perfect Input Address


Input Address with Typo


Input Address with Missing Data

“DPV”:”2″

When the Address Validation – US service returns a DPV score of 2 for an address, it indicates that the address is not in the DPV database of valid mailing addresses. This does not mean that the address does not exist, but rather the address is in a known block but the existence of the address is unknown.

Here is an example of an input that would create a Delivery Point Validation score of 2.


Input Address with Non-Existent Street Number

“DPV”:”3″

When the Address Validation – US service returns a 3 or a 4 for the DPV score, it is indicating that the address is generally correct – however, mailability will be in question because a piece of pertinent information in the address is missing or invalid.

In the case of a DPV score of 3, the apartment or rural route box number is not valid, although the house number or rural route is valid.

The following example demonstrates this.


Input Address with Invalid Suite

“DPV”:”4″

Similarly, for DPV scores of 4, the input record is a valid mailing address but is missing the apartment or rural route box number. Here is an example of this.


Input Address with Missing Suite

The common thread between all these examples is that addresses all exist to one degree or another. For the DPV=1 example, we were able to get the right address, even if we didn’t have all the inputs or there were typos. When it came to the DPV=2 example, the address name, city, state and zip code were good, but the street number was not deliverable. And the examples for DPV scores 3 and 4 both had existing street, city, state and zip code values, but an additional necessary component was missing or invalid.

DPV Note Codes

In addition to the DPV score, we also provide DPV Note codes that provide more insight into the score and the address in general.  For example, an address might receive a DPV score of 1 but also have Note Code “21”, which lets you know that the “Address exists but is vacant”.   Multiple Note Codes maybe returned for a single address.

The table below shows some of the DPV Note codes and their meanings.

DPVNotesDPVNotesDec
1Perfect address
3Unique ZIP code
4Street alias - flag can be double, (i.e. &&) if extended USPS alias rules were applied
11Default ZIP+4 record used to certify the address
13Firm location but was certified as street address or high-rise
14Household or residence indicated by RDI
21Address exists but is vacant
22Address exists but mail is being returned
24SuiteLink did not find Suite or Unit data to append to the address
25Military APO/FPO address
26The input address matched the ZIP+4 record
27The input address did not match the ZIP+4 record
28The input address matched the DPV record
32The input address is a building name, and the primary is missing
35Missing PO box, Rural Route, or Highway Contract box number
36PO box, Rural Route, or Highway Contract primary is invalid
37The input address specified a PMB and matched a CMRA
38Street address
39Highrise apartment/office building address
40General Delivery address
41Post Office Box address
42Rural Route or Highway Contract address
43Firm or Business address
44The input address did not include a PMB and matched a CMRA

Error Codes

There are also instances where an error is returned and no Delivery Point Validation values are returned. In these cases, there is something more critically wrong with the input. We have various groupings of errors which come in the following flavors: Authorization, User Input, Service Objects Fatal and Domain Specific. Let’s look at each of these:

  • Authorization errors occur when there is some issue with your account or license key.
  • User Input errors happen when an input field length limitation has been exceeded or no address data was entered, as well as other scenarios where minimum input requirements were not met.
  • Service Objects Fatal errors are extremely rare and normally due to systems issues; in the rare case they happen, check your network and/or internet connectivity. If these issues are not the problem, please collect the data you entered for the look up and forward it to our support team to review.
  • Domain Specific errors give you feedback on larger problems discovered during address validation such as a street not found, address not found, city or state not found, street number or box number out of range, and many more.

For more details about Delivery Point Validation, error codes and the many operations that can be deployed with Address Validation – US, be sure to check out our comprehensive Developer Guide.

Hopefully, this article has shed additional light on what can be expected from Delivery Point Validation scores, and what to look for when there are additional problems with an address validation.