Option Name optionName Parameter |
Description |
---|---|
Enable U.S. address processing PerformUSProcessing Option.PerformUSProcessing |
Specifies whether or not to process U.S. addresses. If you enable U.S. address processing Get Candidate Addresses will attempt to retrieve candidate addresses for U.S. addresses. If you disable U.S. address processing, U.S. addresses will fail, meaning they are returned with an "F" in the Status output field. The output field Status.Code will say "DisabledCoder." If you are not licensed for U.S. address processing you must disable U.S. address processing in order for your jobs to complete successfully, regardless of whether or not they contain U.S. addresses. Note: You must have a valid license for U.S. address processing to successfully process U.S.
addresses. If you enable
U.S. address processing but are not licensed for this feature,
or your license has expired, you will receive an error. If you enable U.S. address processing but are
not licensed for this feature, or your license has expired, your
entire job will fail.
|
Database Database.US Option.Database.US |
Specifies the database to be used for U.S. address processing. Only databases that have been defined in the US Database Resources panel in the Management Console are available. |
Enable Canadian address processing PerformCanadianProcessing Option.PerformCanadianProcessing |
Specifies whether or not to process Canadian addresses. If you enable Canadian address processing Get Candidate Addresses will attempt to retrieve candidate addresses for Canadian addresses. If you disable Canadian address processing, Canadian addresses will fail, meaning they are returned with an "F" in the Status output field. The output field Status.Code will say "DisabledCoder." If you are not licensed for Canadian address processing you must disable Canadian address processing in order for your jobs to complete successfully, regardless of whether or not they contain Canadian addresses. Note: You must have a valid license for Canadian address processing to successfully process
Canadian addresses. If you
enable Canadian address processing but are not licensed for this
feature, or your license has expired, you will receive an
error. If you enable Canadian address
processing but are not licensed for this feature, or your
license has expired, your entire job will fail.
|
Database Database.Canada Option.Database.Canada |
Specifies the database to be used for Canadian address processing. Only databases that have been defined in the Canadian Database Resources panel in the Management Console are available. |
Enable International address processing PerformInternationalProcessing Option.PerformInternationalProcessing |
Specifies whether or not to process international addresses (addresses outside the U.S. and Canada). If you enable international address processing Get Candidate Addresses will attempt to retrieve candidate addresses for international addresses. If you disable international address processing, international addresses will fail, meaning they are returned with an "F" in the Status output field. The output field Status.Code will say "DisabledCoder." If you are not licensed for international address processing you must disable international address processing in order for your jobs to complete successfully, regardless of whether or not they contain international addresses. Note: You must have a valid license for international address
processing to successfully process international addresses. If you enable international
address processing but are not licensed for this feature, or
your license has expired, you will receive an error. If you enable international address processing
but are not licensed for this feature, or your license has
expired, your entire job will fail.
|
Database Database.International Option.Database.International |
Specifies the database to be used for international address processing. Only databases that have been defined in the International Database Resources panel in the Management Console are available. |
Casing OutputCasing Option.OutputCasing |
Specifies the casing of the output data. One of the following:
|
Maximum records to return MaximumResults Option.MaximumResults |
The maximum number of candidate addresses that Get Candidate Addresses should return. The default is 10. The maximum is 10. |
Return short city name OutputShortCityName Option.OutputShortCityName |
For U.S. addresses, specifies whether or not to return the USPS®-approved abbreviation for the city, if there is one. The USPS® provides abbreviations for city names that are 14 characters long or longer. City abbreviations are 13 characters or less and can be used when there is limited space on the mailing label. If there is no short city name for the city, then the full city name is returned.
|
Dual address match logic DualAddressLogic Option.DualAddressLogic |
(U.S. addresses only). Controls whether Get Candidate Addresses 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. For more information, see About Dual Address Logic.
|
Street matching StreetMatchingStrictness Option.StreetMatchingStrictness |
The strictness of the street name match (U.S. addresses only).
|
Firm matching FirmMatchingStrictness Option.FirmMatchingStrictness |
The strictness of the firm name match (U.S. addresses only).
|
Directional matching DirectionalMatchingStrictness Option.DirectionalMatchingStrictness |
The strictness of the directional match.
|
Perform enhanced street matching PerformESM Option.PerformESM |
Specifies whether or not to perform Enhanced Street Matching (ESM). ESM applies extra matching logic with additional data to any input address that is not matched through the regular address validation process. ESM applies to U.S. addresses only.
|
Search address lines on fail AddressLineSearchOnFail Option.AddressLineSearchOnFail |
Specifies whether ValidateAddress will search address lines for the city, state/province, and postal code. This option enables Validate Address to search the AddressLine input fields for the city, state/province, postal code, and country when the address cannot be matched using the values in the City, StateProvince, and PostalCode input fields. Consider enabling this option if your input addresses have the city, state/province, and postal code information in the AddressLine fields. Consider disabling this option if your input addresses use the City, State/Province and PostalCode fields. If you enable this option and these fields are used, there is an increased possibility that Validate Address will fail to correct values in these fields (for example a misspelled city name).
|