Parses an address into its individual address elements. This is purely a parsing method and it does not validate, correct or verify an address. The operation is useful for parsing street names, suites and other address fragments out of an otherwise undeliverable address. This method can also be used to parse single line addresses.

URL Endpoints

ParseAddress Inputs

NameTypeDescription
AddressStringAddress line of the address to validate or an entire single line address. For example, “123 Main Street” or “123 E Main St Suite 100 Santa Barbara CA 93101”
Address2StringThis line is for address information that does not contribute to the coding of an address. For example “C/O John Smith” does not help validate the address, but is still useful in delivery.
CityStringThe city of the address. For example, “New York”.
StateStringThe state of the address. For example, “NY”.  This does not need to be contracted, full state names will work as well.
PostalCodeStringThe zip code of the address.
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

ParseAddress Outputs

ParseAddressResponse

NameTypeVaulesDescription
AddressFragmentsAddressFragmentsVariesThe parsed address response.
ErrorErrorVariesError object indicating why the service could not return a result. See “Errors” below for more information.

AddressFragments

NameTypeVaulesDescription
AddressStringVariesThe parsed Address line 1.
CityStringVariesThe parsed city name.
StateStringVariesThe parsed state name.
ZipStringVariesThe parsed zip code.
Address2StringVariesThe parsed Address line 2.
FragmentHouseStringVaries

The parsed apartment, box, unit, etc. number of the given address.

123 in 123 North Main St West Apt A

FragmentPreDirStringVaries

The parsed pre-directional of the address's street

North in 123 North Main St West Apt A

FragmentStreetStringVaries

The parsed name of the street in the given address

Main in 123 North Main St West Apt A

FragmentSuffixStringVaries

The parsed suffix of the street in the given address

St in 123 North Main St West Apt A

FragmentPostDirStringVaries

The parsed post-directional of the address's street

West in 123 North Main St West Apt A

FragmentUnitStringVariesThe parsed unit type (e.g. “Apt” or “Ste”).
FragmentStringVariesThe parsed “Fragment” box, apartment or unit number. Same as FragmentPMBNumber.
FragmentPMBPrefixStringVaries

The parsed type of the apartment, box, unit, etc

Apt in 123 North Main St West Apt A

FragmentPMBNumberStringVaries

The parsed apartment, box, unit, etc. number of the given address.

123 in 123 North Main St West Apt A