Standard Address Output - Spectrum_OnDemand - Latest

Spectrum OnDemand Web Services (REST)

Product type
Product family
Spectrum > Geocoding > Enterprise Tax
Spectrum > Web Services
Spectrum > Spatial > Spectrum Spatial
Spectrum > Spectrum Platform
Spectrum > Quality > Addressing
Spectrum > Quality > Spectrum Quality
Spectrum > Spatial > Spectrum Spatial Insights
Spectrum > Discovery
Spectrum OnDemand
Spectrum > Dataflow Designer
Spectrum > Spatial > Spectrum Spatial Analyst
Spectrum > Quality > Context Graph
Product name
Spectrum OnDemand
Spectrum OnDemand Web Services (REST)
First publish date

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.

Table 1. Standard Address Output




The AddressBlock output fields contain a formatted version of the standardized or normalized address as it would be printed on a physical mail piece.

ValidateMailingAddress formats the address into address blocks using postal authority standards. Each line of the address is returned in a separate address block field.

There can be up to nine address block output fields: AddressBlock1 through AddressBlock9.

For example, this input address:

AddressLine1: 4200 Parliament Place

AddressLine2: Suite 600

City: Lanham

StateProvince: MD

PostalCode: 20706

Results in this address block output:

AddressBlock1: 4200 PARLIAMENT PL STE 600

AddressBlock2: LANHAM MD 20706-1882


If the address was validated, the nth line of the validated and standardized address.

If the address could not be validated, the nth line of the input address without any changes.


A two-character code indicating the overall quality of the resulting address (for example, "V5", "C3", and more). This indicator does not consider how much the address had to change.

The first character generally indicates how the address was processed:

V - Verified without change

C - Verified with correction

G - Verified with geocoding

M - Multiple addresses matching

U - Unmatched with reference data.

The second character indicates the precision of the address:

5 - Delivery point confirmed to be a deliverable address.

4 - House number/Building Name is within valid range or known name but can't confirm 100% that premise is deliverable.

3 - Street name is valid, but the house number may not be.

2 - City exists but can't confirm the street does.

1 - State exists but can't confirm City does

0 - Can't confirm any part of the address exists.


This field indicates a single letter code that indicates the type of address. One of the following:

F - The address was validated/corrected to the firm name.

B - The address was validated/corrected to the building name.

G -The address is a general delivery address.

H -The address was validated/corrected to the high-rise default.

L - The address is a large volume receiver.

M - The address is a military address.

P - The address was validated/corrected to PO box.

R - The address was validated/corrected to a rural route.

S - The address was validated/corrected to a street address.

U -The address type is unknown.
City The validated city name.


If no match was found, which address component could not be validated:
  • ApartmentNumber
  • HouseNumber
  • StreetName
  • PostalCode
  • City
  • Directional
  • StreetSuffix
  • Firm
  • POBoxNumber
  • RuralRoute


The country in the format determined by what you selected in OutputCountryFormat:
  • ISO Code
  • UPU Code
  • English
  • French
  • German
  • Spanish


An estimate of confidence that an item mailed or shipped to this address would be successfully delivered. One of the following:

5 - Item will be delivered.

4 - Very confident it is a deliverable address but postal service doesn't provide data to be 100% certain.

3 - Should be deliverable.

2 - Might be delivered.

1 - Doubt it would be delivered.

0 - Extremely unlikely to be delivered.


The validated firm or company name.


Dependent place name that further subdivides a Locality. Examples are colonies in Mexico, Urbanisaciones in Spain.


Indicates which address component had multiple matches, if multiple matches were found:
  • Firm
  • LeadingDirectional
  • PostalCode
  • StreetName
  • StreetSuffix
  • TrailingDirectional
  • Urbanization
Note: More than one component may be returned, in a comma-separated list.


Dependent place name that further subdivides a Locality. An example would be Mahalle in Turkey.


The name of a territory. Territories are larger than a state/province.


The validated postal code for the address.


The optional part of the postal code, according to the country's postal authority.

In the US, it is 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.


The mandatory part of the postal code, according to the country's postal authority. In the US, it is the 5-digit base part of ZIP Code™. For example, in the ZIP Code™ 60655-1844, 60655 is the 5-digit base.


Which address coder processed the address:
U.S. address coder
Canadian address coder
International address coder


The validated state or province abbreviation.


Reports the success or failure of the match attempt. For multiple matches, this field is "F" for all the possible matches.

When set to F, no match of any confidence was found.

Otherwise, if the field is not returned or is returned empty, a match of some confidence was found.


Reason for failure, if there is one. For multiple matches, all possible matches are set to MultipleMatchesFound.

Most common responses are:
  • InsufficientInputData
  • MultipleMatchesFound
  • UnableToValidate


Description of the problem, if there is one.
Possible Multiple Addresses Found
This value will appear if Status.Code=MultipleMatchesFound.
Address Not Found
This value will appear if Status.Code=UnableToValidate.