Standard Address Output

Standard address output consists of four lines of the address which correspond to how the address would appear on an address label. City, state/province, postal code, and other data is also included in standard address output. Standard address output is returned for validated addresses if you set Option.OutputRecordType=A. Standard address fields are always returned for addresses that could not be validated. For non-validated addresses, the standard address output fields contain the address as it appeared in the input ("pass through" data). If you want addresses to be standardized according to postal authority standards when validation fails, specify Option.OutputFormattedOnFail=Y in your request.

Table 1. Standard Address Output

Response Element

Description

AdditionalInputData

Input data not used by the address validation process. For more information, see About Additional Input Data.

AddressLine1

If the address was validated, the first line of the validated and standardized address. If the address could not be validated, the first line of the input address without any changes.

AddressLine2

If the address was validated, the second line of the validated and standardized address. If the address could not be validated, the second line of the input address without any changes.

AddressBlock1-6

If the address was validated, the address line fields contain the validated and standardized address lines. If the address could not be validated, the address line fields contain the input address without any changes.
Note: The last line of the address is contained in the LastLine field.

See the example below.

AddressLine1: 4200 PARLIAMENT PL STE 600
LastLine: LANHAM MD 20706-1882

City

The validated city name.

Country

The country in the format determined by what you selected in Data.OutputCountryFormat:

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

FirmName

The validated firm or company name.

PostalCode

The validated ZIP Code or postal code.

PostalCode.AddOn

The 4-digit add-on part of the ZIP Code. For example, in the ZIP Code 60655-1844, 1844 is the 4-digit add-on. (U.S. addresses only.)

PostalCode.Base

The 5-digit ZIP Code; for example 20706 (U.S. addresses only).

StateProvince

The validated state/province or its abbreviated value.

USUrbanName

The validated urbanization name. (U.S. addresses only.) This is used primarily for Puerto Rico addresses.

DefaultValidPostalCode

This field is generated only for Canadian addresses.
A value of Y indicates that the record is non-correctable (VN) type. In such cases, you have the option of lowering the output Confidence score for the record. To do this, select the Switch default valid postal code confidence check-box in the Input Options. For more information, see section Canadian Address Options.
Note: For all other records, the field value is blank.

PBKey

The PBKey identifier for the address.

The PBKey may be empty even when the address is valid according to USPS rules as the address deliverable via USPS, such as PO Box, but not have a specific physical location.