CDYNE Postal Address Verification VerifyAddress programming method is the barebones Web Service call for users who only need to validate whether or not an address is deliverable. The address deliverability status is returned through the DPV Return Code system, which indicates the parts of the address that are incorrect, and will return corrected information on file with the USPS. This article will take you through three address input and output examples to display some of the important features that the VerifyAddress operation offers.
Example 1: A Correct Address is Confirmed Deliverable
Let’s begin with a correct address and run it through the VerifyAddress Operation. The left hand column shows the input address and the license key. The right hand column displays the corrected address and return code that is sent back by CDYNE Postal Address Verification. There are several differences that immediately jump out between the input and output columns:
- Lowercase letters were changed to all caps
- The secondary address line input value of 200 was appended to the primary address line in the output as “STE 200″
- The zip + 4 value of “23320-2518″ was appended
- A code of “100″ was returned
|
|
|
|
Primary Address Line: 2125 smith ave Secondary Address Line: 200 City: chesapeake State: va Zip: 23320 |
Primary Address Line: 2125 SMITH AVE STE 200 Secondary Address Line: 200 City: CHESAPEAKE State: VA Zip: 23320-2518 |
|
|
|
|
|
|
Although the USPS does not require all capital letters the USPS prefers all caps or uppercase for ease of automatic scanning and application of bar codes. With the VerifyAddress method, address data is returned in all caps. You can use VerifyAddressAdvanced operation to return addresses in proper case.
The USPS preferred location of the secondary address unit designators (i.e. APT, STE, BLDG) is at the end of the delivery address line. In the example above, CDYNE Postal Address Verification correctly moved “200″ to the end of the primary address line, and appended the correct designator of “STE.”
The zip + 4 determines a more precise location than the five-digit zip code alone. The zip + 4 includes the five-digit zip code, a hyphen, and four-digits at the end (i.e. 23320-2518).
The return code of 100 means all parts of the address are confirmed as deliverable. DPV is a USPS validation process that confirms the existence of a specific address (down to the apartment or suite number) and whether or not it is a valid destination for a mailing or package.
CDYNE Postal Address Verification DPV Return Codes:
- 10 – Input address is not found
- 100 – Input address is DPV confirmed for all components
- 101 – Input address is found, but not DPV confirmed
- 102 – Input address primary number is DPV confirmed – Secondary number is present but not DPV confirmed
- 103 – Input address primary number is DPV confirmed – Secondary number is missing
- 200 – Canadian address on input. Verified on city level only
Example 2: Providing Minimal Input Field Information
The minimum address field requirements for CDYNE Postal Address verification to validate an address are one of two combinations:
- Primary address line/city/state
- Primary address line/zip code
In the example below, entering the primary address line, city, and state returns a standardized and corrected address, but the return code in this instance is 103. This means the input address primary number is DPV confirmed, and the secondary number is missing. In other words, there is supposed to be a suite or apartment number, but that information cannot be determined with the input data. This is an opportunity to interact with the data entry in real time, or flag the address in the database for further evaluation.
|
|
|
|
Primary Address Line: 2125 smith ave Secondary Address Line: City: chesapeake State: va Zip: |
Primary Address Line: 2125 SMITH AVE Secondary Address Line: City: CHESAPEAKE State: VA Zip: 23320-2518 |
|
|
|
|
|
|
In the second example, entering the primary address line and zip code also returns a standardized and corrected address with a return code of 103.
|
|
|
|
Primary Address Line: 2125 smith ave Secondary Address Line: City: State: Zip: 23320 |
Primary Address Line: 2125 SMITH AVE Secondary Address Line: City: CHESAPEAKE State: VA Zip: 23320-2518 |
|
|
|
|
|
|
Example 3: Utilizing the Firm Name or Recipient Input Field
CDYNE Postal Address Verification utilizes the USPS SuiteLink database to provide improved business addressing information by appending known secondary (suite) information to business addresses. In the example below, CDYNE Postal Address Verification appended “STE 200″ to the original address because it matched the firm name, “CDYNE” to “STE 200″ in the USPS database. Notice that the input address does not contain a secondary or suite number, but the corrected address does.
|
|
|
|
Primary Address Line: 2125 smith ave Secondary Address Line: City: Chesapeake State: VA Zip: |
Primary Address Line: 2125 SMITH AVE STE 200 Secondary Address Line: City: CHESAPEAKE State: VA Zip: 23320-2518 |
|
|
|
|
|
|
You can read the rest of the blog series by accessing the links below:
Part 1: CDYNE Postal Address Verification API Overview
Part 2: CDYNE Postal Address Verification API Operations Overview
Part 4: CDYNE Postal Address Verification VerifyAddressAdvanced Operation
Part 5: CDYNE Postal Address Verification DPV Code Suggestions
