Dotsaddressvalidation3 NPM

Service Objects - Address Validation 3

DOTS Address Validation 3 US ("AV3") is designed to take an unstandardized address, validate it against the latest USPS data, and return standardized, deliverable addresses. The service provides corrected information such as the correct street location and zip plus four code, along with parsed address tokens, such as the PMB box number, pre- and post-directionals, county and state codes, and much more.

AV3 can provide instant address verification and correction to websites or enhancement to contact lists. However, the output from AV3 must be considered carefully before the existence or non-existence of an address is decided.

Getting Started
GetBestMatches
- Inputs
- Response
GetSecondaryNumbers
- Inputs
- Response
FindAddressLines
- Inputs
- Response
Features
Developer Guide
License Key

Getting Started

Create a new Node.js project
Install the AV3 module
```
npm install dotsaddressvalidation3
```

Load in the module to your project

var AddressValidation3 = require(dotsaddressvalidation3);

Call the getBestMatches() method

AddressValidation3.getBestMatches(
    BusinessName,
    Address, 
    Address2, 
    City, State, 
    PostalCode, 
    LicenseKey, 
    Environment, 
    function(err, response){...}
);

Call the getSecondaryNumbers() method

AddressValidation3.getSecondaryNumbers(
    Address, 
    City, 
    State, 
    PostalCode, 
    LicenseKey, 
    Environment, 
    function(err, response){...}
);

Call the findAddressLines() method

AddressValidation3.findAddressLines(
    Address1, 
    Address2, 
    Address3, 
    Address4, 
    Address5, 
    Address6, 
    City, 
    State, 
    PostalCode, 
    LicenseKey, 
    Environment, 
    function(err, response){...}
);

GetBestMatches

Inputs

Parameter	Type	Value
BusinessName	String	Name of business associated with this address. Used to append Suite data.
Address1	String	Address line of the address to validate. For example, "123 Main Street".
Address2	String	This line is for address information that does not contribute to DPV coding an address. For example "C/O John Smith" does not help validate the address, but is still useful in delivery.
City	String	The city of the address to validate. For example, "New York". The city isn't required, but if one is not provided, the Zip code is required.
State	String	The state of the address to validate. For example, "NY". This does not need to be contracted, Full state names will work as well. The state isn't required, but if one is not provided, the Zip code is required.
PostalCode	String	The zip code of the address to validate. A zip code isn't required, but if one is not provided, the City and State are required.
LicenseKey	String	Your license key to use the service.
Environment	String	"trial" OR "production"

Response

{
	"Addresses":[{
		"Address1":"String content",
		"Address2":"String content",
		"City":"String content",
		"State":"String content",
		"Zip":"String content",
		"IsResidential":"String content",
		"DPV":"String content",
		"DPVDesc":"String content",
		"DPVNotes":"String content",
		"DPVNotesDesc":"String content",
		"Corrections":"String content",
		"CorrectionsDesc":"String content",
		"BarcodeDigits":"String content",
		"CarrierRoute":"String content",
		"CongressCode":"String content",
		"CountyCode":"String content",
		"CountyName":"String content",
		"FragmentHouse":"String content",
		"FragmentPreDir":"String content",
		"FragmentStreet":"String content",
		"FragmentSuffix":"String content",
		"FragmentPostDir":"String content",
		"FragmentUnit":"String content",
		"Fragment":"String content",
		"FragmentPMBPrefix":"String content",
		"FragmentPMBNumber":"String content"
	}],
	"Error":{
		"Type":"String content",
		"TypeCode":"String content",
		"Desc":"String content",
		"DescCode":"String content"
	},
	"IsCASS":true
}

GetSecondaryNumbers

Inputs

Parameter	Type	Value
Address	String	Address line of the address to validate. For example, "123 Main Street".
City	String	The city of the address to validate. For example, "New York". The city isn't required, but if one is not provided, the Zip code is required.
State	String	The state of the address to validate. For example, "NY". This does not need to be contracted, Full state names will work as well. The state isn't required, but if one is not provided, the Zip code is required.
PostalCode	String	The zip code of the address to validate. A zip code isn't required, but if one is not provided, the City and State are required.
LicenseKey	String	Your license key to use the service.
Environment	String	"trial" OR "production"

Response

{
	"Address1":"String content",
	"Error":{
		"Type":"String content",
		"TypeCode":"String content",
		"Desc":"String content",
		"DescCode":"String content"
	},
	"City":"String content",
	"State":"String content",
	"Zip":"String content",
	"SecondaryNumbers":["String content"],
	"TotalCount":2147483647
}

FindAddressLines

Inputs

Parameter	Type	Value
Address1	String	Address line of the address to validate. For example, "123 Main Street".
Address2	String	This line is for address information that does not contribute to DPV coding an address. For example "C/O John Smith" does not help validate the address, but is still useful in delivery.
Address3	String	Any address information that should belong in Address1 or Address2 lines.
Address4	String	Any address information that should belong in Address1 or Address2 lines.
Address5	String	Any address information that should belong in Address1 or Address2 lines.
Address6	String	Any address information that should belong in Address1 or Address2 lines.
City	String	The city of the address to validate. For example, "New York". The city isn't required, but if one is not provided, the Zip code is required.
State	String	The state of the address to validate. For example, "NY". This does not need to be contracted, Full state names will work as well. The state isn't required, but if one is not provided, the Zip code is required.
PostalCode	String	The zip code of the address to validate. A zip code isn't required, but if one is not provided, the City and State are required.
LicenseKey	String	Your license key to use the service.
Environment	String	"trial" OR "production"

Response

{
	"Error":{
		"Type":"String content",
		"TypeCode":"String content",
		"Desc":"String content",
		"DescCode":"String content"
	},
	"BestAddress1":"String content",
	"BestAddress2":"String content",
	"City":"String content",
	"State":"String content",
	"PostalCode":"String content"
}

Features

For trial keys, set the Environment variable to "trial". Once you purchase a production license key, swap the Environment variable to "production" and change out your LicenseKey to your new license key.

The module automatically handles failover logic when using the production environment. This helps to ensure your web service requests are made sucessfully regardless of any network interuptions.