Standard Address Output

AddressBlock1-AddressBlock9

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

ValidateMailingAddressPremium 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:

AddressLine2: Suite 600

City: Lanham

StateProvince: MD

PostalCode: 20706

Results in this address block output:

AddressBlock2: LANHAM MD 20706-1882

AddressLine1-AddressLine5

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.

AddressQuality

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

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

AddressType

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.

CouldNotValidate

Country

Deliverability

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.

FirmName

The validated firm or company name.

Locality

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

ChangeScore

A value of 0 and 100 that reflects how much the address has changed to make it valid, excluding standardization of terms (for example: 'street' to 'ST') and mild reformatting of terms. If the address changes too much, it is risker to use.

A value of 100 means no changes to the address were needed. 0 means the address is completely invalid.

This value is used to assist the caller to determine whether the address is safe enough to use. Exactly which value to determine whether an address is safe or not depends on the use case.

Latitude

Latitude of the candidate.

Longitude

Longitude of the candidate.

DPID

The Delivery Point Identifier. An eight-digit number from the Australia Post Postal Address File that uniquely identifies a mail delivery point, such as a street address.

LocationPrecision

CountryLevel

The category of address matching available. This is always "A" for U.S. and Canadian addresses. One of the following:

A

The address is in a country for which there is highly detailed postal data available. Addresses in this match level can have the following address elements validated and corrected, and added if missing from the input:

• Postal code
• City name
• State/county name
• Street address elements
• Country name

B

The address is in a country for which there is a medium level of postal data available. Addresses in this match level can have the following address elements validated and corrected, and added if missing from the input:

• Postal code
• City name
• State/county name
• Country name

C

The address is in a country for which the postal data is least detailed. Addresses in this match level can have the following actions performed on them:

• Validate and correct country name (cannot supply missing country name)

• Validate the format of the postal code (cannot supply missing postal code or validate the code)

StateProvince.Abbrev

The abbreviated value for a state or province.

RecordType.Default

Code indicating the "default" match:

Y

The address matches a default record.

null

The address does not match a default record.

MultipleMatches

Suburb

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

Territory

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

PostalCode

The validated postal code for the address.

PostalCode.AddOn

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.

PostalCode.Base

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.

ProcessedBy

StateProvince

The validated state or province abbreviation.

Status

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.

Status.Code

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

Status.Description