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.
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 |
City |
The validated city name. |
Country |
The country in the format determined by what you selected in Data.OutputCountryFormat:
|
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. |