Response - Spectrum_OnDemand - addressing - web_services - Latest

Spectrum OnDemand Web Services (REST)

Product type
Software
Portfolio
Verify
Product family
Spectrum
Product
Spectrum > Discovery
Spectrum > Web Services
Spectrum > Spatial > Spectrum Spatial Insights
Spectrum > Dataflow Designer
Spectrum > Geo Addressing > Enterprise Tax
Spectrum > Spatial > Spectrum Spatial Analyst
Spectrum OnDemand
Spectrum > Quality > Context Graph
Spectrum > Spectrum Platform
Spectrum > Quality > Addressing
Spectrum > Spatial > Spectrum Spatial
Spectrum > Quality > Spectrum Quality
Version
Latest
Language
English
Product name
Spectrum OnDemand
Title
Spectrum OnDemand Web Services (REST)
Copyright
2024
First publish date
2006
Last updated
2024-08-28
Published on
2024-08-28T12:55:51.727818

GetCandidateAddresses returns the following output.

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 Module 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.