About Dual Address Logic

For U.S. addresses only, the DualAddressLogic option controls whether ValidateAddress 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 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

ValidateAddress would return one of the following:

  • If DualAddressLogic is set to either N or P:

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

  • If 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 StandardAddressFormat=D. For more information, see Default Options. 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 StandardAddressFormat=D then the address information not used to standardize the address is returned in the AdditionalInputData field. For more information on this option, see Default Options. 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 StandardAddressFormat option to D. For more information, see Default Options .