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 ValidateMailingAddressUSCAN 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 ValidateMailingAddressUSCAN validated the address.

To include parsed input fields in the output, set Option.OutputRecordType=I.

Table 1. Parsed Input

Response Element

 Max Field Length

Description

ApartmentLabel.Input

6

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

ApartmentNumber.Input

10

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

CanadianDeliveryInstallationAreaName.Input

32

Delivery installation name (Canadian addresses only)

CanadianDeliveryInstallationQualifierName.Input

17

Delivery installation qualifier (Canadian addresses only)

CanadianDeliveryInstallationType.Input

7

Delivery installation type (Canadian addresses only)

City.Input

Same as provided in input

Validated city name

Country.Input

Same as provided in input

Country. Format is determined by what you selected in Data.OutputCountryFormat:

  • ISO Code
  • UPU Code
  • English
  • French
  • German
  • Spanish

FirmName.Input

2

The validated firm or company name

HouseNumber.Input

10

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

LeadingDirectional.Input

2

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

POBox.Input

10

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

PostalCode.Input

Same as provided in input

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

PrivateMailbox.Input

20

Private mailbox indicator

PrivateMailbox.Type.Input

11

The type of private mailbox. Possible values include:

  • Standard
  • Non-Standard

RRHC.Input

5

Rural Route/Highway Contract indicator

StateProvince.Input

Same as provided in input

Validated state or province name

StreetName.Input

45

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

StreetSuffix.Input

4

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

TrailingDirectional.Input

2

Trailing directional, for example: 123 Pennsylvania Ave NW

USUrbanName.Input

Same as provided in input

USPS® urbanization name