USPS: Address Validation

ActiveProspect offers the United States Postal Service (USPS) Address Validation API directly through LeadConduit.

What It Does

The USPS Address Validation enhancement corrects errors in street addresses, including abbreviations and missing information, and supplies ZIP Codes and ZIP Codes + 4. The API also returns data like vacancy and address type (business versus individual) you can use to validate an address based on your business model.


Adding Credentials

NOTE: USPS Address Validation is a Bring Your Own Credentials Enhancement, meaning you must sign up with USPS at to receive a Username.


Using USPS Address Validation


Open your flow edit to the Steps tab, click Add Enhancement, select USPS, and configure the enhancement. You're prompted with options for determining whether an address is bad or good, including:

  • Delivery Point Validation (DPV) ConfirmationThe primary method used by the USPS to determine whether an address is deliverable or undeliverable.
  • Vacant Indicator - This indicates whether a formerly occupied address is currently vacant (unoccupied over 90 days in most cases) and thus not receiving mail delivery.

  • Business Address - This indicates whether or not the address belongs to a business (versus any form of a personal residence).

  • Central Delivery Point - This indicates whether or not the address is provided USPS services from a centrally located installation (commonly found in apartment complexes and newer residential developments).

  • DPV Commercial Mail Receiving Agency (CMRA) - Also known as a mail drop, this indicates the address is associated with a known Private Mailbox Operator.

The UI provides more detail and configuration options for establishing what constitutes a good or bad address.

Making a Decision

The final step in configuring USPS Address Validation is deciding whether or not you want to fail a lead when the address is deemed bad. 



Depending on your selections, both the USPS Address Validation step and the corresponding filter will be added to your flow.

If you are adding USPS to a previously constructed flow, be sure to drag both USPS and the related filter into the correct location in your flow.

Click OK, then Save the flow and you're ready to go!

Adding Credentials

If you added USPS Address Validation without your credentials, you can add your credentials by expanding the USPS step and clicking on the Edit Field Mapping button.


Appended Data

The enhancement returns the following information:

Field Detail Example
Outcome The status of the recipient event success
Reason When the outcome is other than Success, a reason for the Outcome is provided.  
Company Name When provided, the name of the business is echoed back in the response THE LAW OFFICE OF JESSICA A BROWN, PLLC
Address 1 The normalized Line 1 of the Address 1902 AGGIE LN
Address 2 The normalized Line 2 of the Address  
City The normalized City AUSTIN
State The normalized State TX
Urbanization For Puerto Rican addresses; contains area, sector, or development within a geographic area; should be included after the name of the recipient  
Postal Code The normalized Zip+4 Postal Code 78757-1836
Delivery Point The Delivery Point is a specific set of digits between 00 and 99 assigned to every address. When combined with the ZIP + 4 code, the delivery point provides a unique identifier for every deliverable address served by the USPS. 2
Carrier Route A group of addresses that receive the same USPS code to aid in efficient mail delivery. C082
Footnotes Indicates which changes were made to the input address. Footnotes are delimited by a # character.  
DPV Confirmation A boolean flag reporting whether or the address was DPV confirmed deliverable (in part or in whole) Y
DPV Central Mail Receiving Agency A boolean flag reporting whether the address is a CMRA (also known as a mail drop). These typically operate as Private Mailbox Operators. N
DPV False Positive A false positive record was detected.  
DPV Footnotes Indicates why the address was given its DPV value and potentially the type of ZIP Code that was matched. All these footnotes have a length of 2 characters, and there may be up to 14 footnotes. AABB




Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


You must be logged in to comment.