Parsed Input

The output can include the input address in parsed form. This type of output is referred to as "parsed input." Parsed input fields contain the address data that was used as input regardless of whether or not ValidateAddress validated the address. Parsed input is different from the "parsed address elements" output in that parsed address elements contain the validated address if the address could be validated, and, optionally, the input address if the address could not be validated. Parsed input always contains the input address regardless of whether or not ValidateAddress validated the address.

To include parsed input fields in the output,.

Table 1. Parsed Input

Response Element

Description

ApartmentLabel.Input

Apartment designator (such as STE or APT), for example: 123 E Main St APT 3

ApartmentNumber.Input

Apartment number, for example: 123 E Main St APT 3

City.Input

Validated city name

Country.Input

Country. Format is determined by what you selected in :

  • ISO Code
  • UPU Code
  • English

County.Input*

The smallest geographic data element within a country, for instance, USA County

FirmName.Input

The validated firm or company name

HouseNumber.Input

House number, for example: 123 E Main St Apt 3

LeadingDirectional.Input

Leading directional, for example: 123 E Main St Apt 3

POBox.Input

Post office box number. If the address is a rural route address, the rural route box number will appear here.

PostalCode.Input

Validated postal code. For U.S. addresses, this is the ZIP Code.

Principality.Input *

The largest geographic data element within a country

StateProvince.Input

Validated state or province name

StreetAlias.Input

Alternate street name; typically applies only to a specific range of addresses on the street. If you do not allow street aliases in the output then the street's "base" name will appear in the output regardless of whether or not there is an alias for the street. The base name is the name that applies to the entire street. For example: If StreetName is “N MAIN ST” the StreetAlias field would contain “MAIN” and the thoroughfare type,"ST", would be returned in the StreetSuffix field.

StreetName.Input

Street name, for example: 123 E Main St Apt 3

StreetSuffix.Input

Street suffix, for example: 123 E Main St Apt 3

Subcity.Input*

A smaller population center data element, dependent on the contents of the Locality field. For instance, Turkish Neighbourhood.

Substreet.Input*

The dependent street or block data element within a country. For instance, UK Dependent Street.

TrailingDirectional.Input

Trailing directional, for example: 123 Pennsylvania Ave NW

*This is a subfield and may not contain data.