You can specify one or more languages on the PreferredLanguage property. Use the three-letter ISO 639 code associated with each language that you specify. Add a list of one or more languages as an array to the PreferredLanguage property. Address Verification tries to return an address in the most-preferred language based on the order that you specify in the array. If the first language that you specify is not present in the reference data, Address Verification tries to return the address in the next language in the array.

For example, when you submit NLD, FRA, and DEU as the list of preferred languages, Address Verification returns the address in Flemish. If the reference data does not contain the address in Flemish, Address Verification returns the address in French if available.

The following code fragment shows a sample of one or more languages in the PreferredLanguage property:

By default, the input list of preferred languages is empty. When the input list is empty, Address Verification returns the default language.

You can configure the property to return an address in the language that the input address uses. The PRESERVE option is useful in cases where the input address set contains address records that are not recorded in the default language. Address Verification can preserve the input language if the reference data contains the address information in the input language. To preserve the input language, add PRESERVE as the first entry in the PreferredLanguage property. You can also add language codes after the PRESERVE option.

If Address Verification cannot return an address in the input language, Address Verification tries to return the address in the next language that you specified in the list of preferred languages. If the input list is empty, Address Verification returns the address in the default language.

You can receive an address in more than one language in a single verification job. To return more than one language at once, add an instance of the Standardizations object for each language and set the PreferredLanguage property for each instance.

For example, to receive Flemish and French languages in the output, add two instances of the Standardizations object and specify NLD and FRA as the preferred language in each instance.