Response

Table 1. GetCandidateAddresses Output
Response Element	Description
AddressLine1	The first address line.
AddressLine2	The second address line.
AddressLine3	The third address line.
AddressLine4	The fourth address line.
AddressLine5	For U.K. addresses only. If the address was validated, the fifth line of the validated and standardized address. If the address could not be validated, the fifth line of the input address without any changes.
CanadianDeliveryInstallation AreaName	Delivery installation name (Canadian addresses only)
CanadianDeliveryInstallation QualifierName	Delivery installation qualifier (Canadian addresses only)
CanadianDeliveryInstallation Type	Delivery installation type (Canadian addresses only)
City	The city name.
Country	The three-character ISO 3166-1 Alpha 3 code for the country. For a list of ISO codes, see ISO Country Codes and Coder Support.
FirmName	The firm name.
HouseNumberHigh	The ending house number for the range in which the candidate address's house number falls.
HouseNumberLow	The beginning house number for the range in which the candidate address's house number falls.
HouseNumberParity	Indicates the numbering scheme for the house numbers between HouseNumberLow and HouseNumberHigh, as follows: E Only even values O Only odd values B Both
MatchLevel	For addresses outside the U.S. and Canada, identifies the match level for the candidate address. U.S. and Canadian addresses are always "A." One of the following: A The candidate matches the input address at the street level. B The candidate matches the input address at the state/province level.
PostalCode	The postal code. In the U.S. this is the ZIP Code™.
PostalCode.AddOn	The last four digits of the ZIP + 4® Code. U.S. addresses only.
RecordType	The type of address record, as defined by U.S. and Canadian postal authorities (U.S. and Canadian addresses only): FirmRecord GeneralDelivery HighRise PostOfficeBox RRHighwayContract Normal
RecordType.Default	Code indicating the "default" match: Y The address matches a default record. null The address does not match a default record.
StateProvince	The validated state/province or its abbreviated value.
Status	Reports the success or failure of the match attempt. null Success F Failure
Status.Code	The reason for failure, if there is one. There is only one possible value: DisabledCoder RequestFailed
Status.Description	A description of the problem, if there is one. Did not return multiples The input address matched only one address in the database. GetCandidateAddresses only returns data if multiple possible matches were found. Number of candidates is not greater than 1 The input address matched more than one address in the database but no addresses were returned. PerformUSProcessing disabled This value will appear if Status.Code=DisabledCoder. PerformCanadianProcessing disabled This value will appear if Status.Code=DisabledCoder. PerformInternationalProcessing disabled This value will appear if Status.Code=DisabledCoder.
UnitNumberHigh	The ending unit number for the range in which the candidate address's unit number falls.
UnitNumberLow	The beginning unit number for the range in which the candidate address's unit number falls.
UnitNumberParity	Indicates the numbering scheme for the unit numbers between UnitNumberLow and UnitNumberHigh, as follows: E Only even values O Only odd values B Both
USUrbanName	The validated city urbanization name. Urbanization names are used primarily for Puerto Rico addresses.

AddressLine1

The first address line.

AddressLine2

The second address line.

AddressLine3

The third address line.

AddressLine4

The fourth address line.

AddressLine5

For U.K. addresses only. If the address was validated, the fifth line of the validated and standardized address. If the address could not be validated, the fifth line of the input address without any changes.

CanadianDeliveryInstallation

AreaName

Delivery installation name (Canadian addresses only)

CanadianDeliveryInstallation

QualifierName

Delivery installation qualifier (Canadian addresses only)

CanadianDeliveryInstallation

Type

Delivery installation type (Canadian addresses only)

City

The city name.

Country

The three-character ISO 3166-1 Alpha 3 code for the country. For a list of ISO codes, see ISO Country Codes and Coder Support.

FirmName

The firm name.

HouseNumberHigh

The ending house number for the range in which the candidate address's house number falls.

HouseNumberLow

The beginning house number for the range in which the candidate address's house number falls.

HouseNumberParity

Indicates the numbering scheme for the house numbers between HouseNumberLow and HouseNumberHigh, as follows:

E: Only even values
O: Only odd values
B: Both

MatchLevel

For addresses outside the U.S. and Canada, identifies the match level for the candidate address. U.S. and Canadian addresses are always "A." One of the following:

A: The candidate matches the input address at the street level.
B: The candidate matches the input address at the state/province level.

PostalCode

The postal code. In the U.S. this is the ZIP Code™.

PostalCode.AddOn

The last four digits of the ZIP + 4® Code. U.S. addresses only.

RecordType

The type of address record, as defined by U.S. and Canadian postal authorities (U.S. and Canadian addresses only):

FirmRecord
GeneralDelivery
HighRise
PostOfficeBox
RRHighwayContract
Normal

RecordType.Default

Code indicating the "default" match:

Y: The address matches a default record.
null: The address does not match a default record.

StateProvince

The validated state/province or its abbreviated value.

Status

Reports the success or failure of the match attempt.

null: Success
F: Failure

Status.Code

The reason for failure, if there is one. There is only one possible value:

DisabledCoder
RequestFailed

Status.Description

A description of the problem, if there is one.

Did not return multiples: The input address matched only one address in the database. GetCandidateAddresses only returns data if multiple possible matches were found.
Number of candidates is not greater than 1: The input address matched more than one address in the database but no addresses were returned.
PerformUSProcessing disabled: This value will appear if Status.Code=DisabledCoder.
PerformCanadianProcessing disabled: This value will appear if Status.Code=DisabledCoder.
PerformInternationalProcessing disabled: This value will appear if Status.Code=DisabledCoder.

UnitNumberHigh

The ending unit number for the range in which the candidate address's unit number falls.

UnitNumberLow

The beginning unit number for the range in which the candidate address's unit number falls.

UnitNumberParity

Indicates the numbering scheme for the unit numbers between UnitNumberLow and UnitNumberHigh, as follows:

E: Only even values
O: Only odd values
B: Both

USUrbanName

The validated city urbanization name. Urbanization names are used primarily for Puerto Rico addresses.