Page tree
Skip to end of metadata
Go to start of metadata



This operation organizes really bad address data that is broken up into multiple arbitrary address fields.This function will sort up to six possible address lines and return what it thinks are the most probable candidates for the USPS Address1 and possibly Address2. For example, people’s names in the Address1 line mixed with actual street address lines

URL Endpoints


 JSON

https://trial.serviceobjects.com/AV3/api.svc/FindAddressLinesJson?Address1={ADDRESS1}&Address2={ADDRESS2}&Address3={ADDRESS3}&Address4={ADDRESS4}&Address5={ADDRESS5}&Address6={ADDRESS6}&City={CITY}&State={STATE}&PostalCode={POSTALCODE}&LicenseKey={LICENSEKEY} 

XML

https://trial.serviceobjects.com/AV3/api.svc/FindAddressLines?Address1={ADDRESS1}&Address2={ADDRESS2}&Address3={ADDRESS3}&Address4={ADDRESS4}&Address5={ADDRESS5}&Address6={ADDRESS6}&City={CITY}&State={STATE}&PostalCode={POSTALCODE}&LicenseKey={LICENSEKEY} 


FindAddressLines Inputs


NameTypeDescription
Address1StringAddress line of the address to validate.
For example, "123 Main Street".
Address2StringThis 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.
Address3StringAny address information that should belong in Address1 or Address2 lines.
Address4StringAny address information that should belong in Address1 or Address2 lines.
Address5StringAny address information that should belong in Address1 or Address2 lines.
Address6StringAny address information that should belong in Address1 or Address2 lines.
CityStringThe 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.
StateStringThe 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.
PostalCodeString

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*StringYour license key to use the service.  
Sign up for a free trial key at https://www.serviceobjects.com/products/address-geocoding/usps-address-validation


FindAddressLines Outputs


AddressLinesResponse

Name

Type

Values

Description

Address

Address[]

Varies

The corrected address candidates.

Error


ErrorVariesError object indicating why the service could not return a result. See “Errors” below for more information.


Address

Name

Type

Values

Description

BestAddress1

String

Varies

The most probable address line 1.

BestAddress2

String

Varies

The most probable address line 2.

City

String

Varies

The city name.

State

String

Varies

The state name.

Zip

String

Varies

The zip code.


  • No labels