About Dual Address Logic

For U.S. addresses only, the Option.DualAddressLogic option controls whether ValidateMailingAddressUSCAN should return a street match or a PO Box/Rural Route/Highway Contract match when the address contains both street and PO Box/Rural Route/Highway Contract information in the same address line.

Note:
The Option.DualAddressLogic option has no effect if the street information is in a different address line input field than the PO Box/Rural Route/Highway Contract information.

For example, given the following input address:

AddressLine1: 401 N Main St Apt 1 POB 1
City: Kemp
StateProvince: TX
PostalCode: 75143

ValidateMailingAddressUSCAN would return one of the following:

  • If Option.DualAddressLogic is set to either N or P:

    AddressLine1: PO Box 1
    City: Kemp
    StateProvince: TX
    PostalCode: 75143-0001

  • If Option.DualAddressLogic is set to S:

    AddressLine1: 401 N Main St Apt 1
    City: Kemp
    StateProvince: TX
    PostalCode: 75143-4806

The address data that is not used to standardize the address can be returned in one of two places:

  • AddressLine2—The address information not used to standardize the address is returned in the AddressLine2 field if you specify Option.StandardAddressFormat=D. For example, if you choose to return a street match for dual addresses,

    AddressLine1: 401 N Main St Apt 1
    AddressLine2: PO Box 1
    City: Kemp
    StateProvince: TX
    PostalCode: 75143-0001

  • AdditionalInputData—If you do not specify Option.StandardAddressFormat=D then the address information not used to standardize the address is returned in the AdditionalInputData field. For example, if you choose to return a street match for dual addresses,

    AddressLine1: 401 N Main St Apt 1
    City: Kemp
    StateProvince: TX
    PostalCode: 75143-0001
    AdditionalInputData: PO Box 1

Address information that is dropped can be retrieved by setting the Option.StandardAddressFormat option to D.