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

 Max Field Length

Description

AdditionalInputData

102

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

AddressLine1

201

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

201

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

30

The validated city name.

Country

25 (it varies based on the input country)

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

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

FirmName

41

The validated firm or company name.

PostalCode

6+5

The validated ZIP Code™ or postal code.

PostalCode.AddOn

5

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

6

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

StateProvince

3

The validated state/province or its abbreviated value.

USUrbanName

30

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

DefaultValidPostalCode

 1 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

 Not Applicable 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.