Part 1: CDYNE Postal Address Verification API Overview
CDYNE Postal Address Verification is a CASS Certified™ API that checks U.S. addresses against a continuously updated USPS® database to standardize, correct, and validate addresses in one step. It will reduce non-deliverable addresses, ensure the fastest delivery possible, and qualify your mailings for USPS discounts.
An API, or Application Programming Interface, acts as the interface between business web applications, programs, or databases and the CDYNE Postal Address Verification process. The advantage of using a Web Service API is the ability to add advanced features into your business applications without maintaining the software or hardware required to run that feature. CDYNE Postal Address Verification API enables a business IT department to implement address verification capabilities within their existing systems with a minimal time and money investment.
CDYNE Postal Address Verification API is CASS Certified™ for the most recent Cycle N by the USPS®, which means our software passed the stringent evaluation and testing process the USPS requires for correction accuracy in the areas listed below. As part of the CDYNE Postal Address Verification offering, the following data is included in the pricing.
DPV is a USPS address 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. With CDYNE Postal Address Verification API, DPV is indicated by the return code. The example below shows a return code of 100, which means all parts of the address have been DPV confirmed. In other words, the address is verified as deliverable.
The example below also shows other features included with CDYNE Postal Address Verification. Notice how the input address is standardized in all caps (per USPS formatting guidelines), corrected (“Suite” is changed to “STE” and the 4-digit zip “2518” is appended to the original zip code provided), and validated for deliverability with a return code of 100.
CDYNE Postal Address Verification returns the following result codes for DPV with the VerifyAddress operation. This is the barebones operation for users who only need to validate whether or not an address is deliverable. For more detailed DPV return codes and suggested interactions, use the VerifyAddressAdvanced Operation, which is discussed in detail in Part 4: CDYNE Postal Address Verification VerifyAddressAdvanced Operation.
- 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
LACSLink® is a system that matches addresses against a list of rural route, highway route, and box number addresses that have been renumbered or renamed due to 911 address conversions. These conversions involve changing rural-style addresses to city-style addresses for 911 emergency system implementations. LACS stands for Locatable Address Conversion Service. The greatest advantage of LACSLink processing is that it reduces undeliverable mail and ensures that your lists have the most current address information on file, which lowers costs and provides faster delivery. The example below is a made-up address to illustrate how CDYNE Postal Address Verification handles LACSLink return data.
There are three LACSLink code fields that include the LACS Flag, LACS Indicator, and LACS Return Code. CDYNE Postal Address Verification returns the following result codes.
LACS Flag – this indicates whether or not there is an address match with the LACSLink database.
- Y – LACS record match – the input address matched to a record in the master file, and a new address could be provided.
- S – LACS record/secondary number dropped – the input address matched to a record in the master file, but the input address had a secondary number and the master record file did not.
- N – No match – the input address could not be matched to a record in the master file, and a new address could not be provided.
- F – False positive – a false positive record was detected
LACS Indicator – this indicates whether or not the input address has a conversion in the USPS LACSLink database.
- L – There is a conversion address in the LACSLink database
- Blank – No conversion address was found
LACS Return Code – this indicates the reason for the LACS Indicator returned (“L” or “blank”).
- A – Match – Address Provided – there is a LACSLink record match and a converted address is provided
- 00 – No Match – there is no match and no converted address
- 14 – Match – No Conversion – found LACSLink record, but could not convert the data to a deliverable address
- 92 – Match – Dropped Secondary Number – LACSLink record matched after dropping the secondary number from input address
RDI or Residential Delivery Indicator identifies whether an address is classified as residential or business. Most shipping companies charge a higher price for residential deliveries. Businesses can use RDI data to maximize savings by flagging residential addresses and then shopping for the most cost-effective delivery option. In the following example, the Residential Delivery Indicator is “N,” which indicates that the address is classified as a business (rather than residential) by the USPS.
CDYNE Postal Address Verification returns the following result codes for Residential Delivery Indicator:
- Y – Address is residential
- N – Address is commercial
USPS SuiteLink data provides 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.
CDYNE Postal Address Verification returns the following Suite Link Return Codes:
- A – SuiteLink Match
- 00 – No Match – SuiteLink look up was attempted, but a match was not made
- Blank – SuiteLink lookup was not performed
Enhanced Line of Travel or eLOT was developed by the USPS to give mailers the ability to sort their mailings in approximate carrier-casing sequence. eLOT codes organize the delivery points within a zip+4 code in the order that the carrier travels as they deliver mail. Mailers may use eLOT processing to qualify for enhanced carrier route presort discounts.
The eLOT Sequence Number aids in mail sorting, and the USPS defines it as the first occurrence of delivery made to the add-on range within the carrier route. The eLOT Ascending/Descending Code indicates the approximate delivery order within the sequence number.
POSTNET™ – or Postal Numeric Encoding Technique was developed by the USPS to encode zip code information to improve speed, accuracy, and delivery of mail. It allows for rapid and reliable sorting by barcode sorters and provides additional automation discounts for bulk mailings. CDYNE Postal Address Verification returns a POSTNET Barcode string that can be used to generate a barcode image.
The string data in the POSTNET Barcode return consists of the following data, which can be used to generate a barcode for postal mailing discounts.
- Start character (“f”)
- Nine digit zip code data (“23320 2518”)
- Delivery point data (“50”)
- Check digit (“9”)
- Stop character (“f”)
IM™ Barcode – The Intelligent Mail barcode is the next generation of USPS barcode technology used to sort and track letters and flats. It combines the capabilities of the POSTNET™ barcode and the PLANET Code® barcode into one unique barcode. Bulk mail that is barcoded is eligible for additional USPS discounts. To qualify for these discounts, the USPS requires an accurate Zip + 4 code, which can be matched with CASS Certified software.
CDYNE Postal Address Verification returns a key that can be used to obtain the Intelligent Mail Barcode string to generate a barcode image. Read more details about this in the GetIntelligentMailBarcode section of Part 2: CDYNE Postal Address Verification API Operations Overview .
In this five-part blog series, we will take a more in-depth look at the programming operations that CDYNE Postal Address Verification API will perform as well as how to use the operations and understand the data returns. Click on the links below to read each article.