Frequently Asked Questions (FAQ)

Home > Support > FAQ

Frequently Asked Questions (FAQ)

In the FAQ section you can find answers to frequently asked questions. If your questions aren't answered here feel free to contact our Opens internal link in current windowsales department or Opens internal link in current windowsupport team.


How can I decide in which character set or language my address is returned?

Starting with Version 5.5.0, you can choose to preserve the input script of addresses from Belarus, China, Greece, Japan, Kazakhstan, Macedonia, Russia and Ukraine. To retain the input script in the output, you must set the PreferredScript parameter in parameter.xml to PRESERVE_INPUT.

If the input contains more than one script, AddressDoctor returns the address in the default script in the reference database.

If the input contains address elements that are not in the corresponding database, AddressDoctor copies such elements to the output in the same script the address was input.

When does AddressDoctor preserve locality aliases and vanity names?

Starting with Version 5.5.0, you can choose to retain locality aliases, also known as vanity names, in the validated output. You can set AliasStreet and AliasLocality values in the parameter.xml to define the handling of aliases for streets and localities.

If you want AddressDoctor to preserve the vanity name in the validated output, you must set the respective parameters to PRESERVE. If you want AddressDoctor to return the postal name in the validated output, set the respective parameters to OFF.

If you want to validated addresses in the Certified mode and generate output that conforms to the postal regulations of the country, you must ensure that the parameters are set to the default value OFFICIAL.

Why does AddressDoctor not validate my Taiwanese addresses?

Currently AddressDoctor supports only Taiwanese addresses that are in the Latin Script. For example:

Xue Li (Recipient Name)
Alley 1 Lane 170 (Dependent Street)
12 Dali St. (House Number and Major Street)
Wanhua Dist. (Locality 2 and District)
Taipei City 10856 (City and Locality 1 and Postal Code)

To enable support for Taiwanese addresses, you must get the unlock code for the Taiwan database from the AddressDoctor sales team. 

Does AddressDoctor validate Irish postal addresses?


Due to popular customer demand, AddressDoctor has introduced support for Ireland in version 5.3.0. In Ireland, postal addresses do not use a postal code system. Rural addresses are specified by the county, nearest post town and the townland. Urban addresses are specified by county, city or town name, street name, house number, and apartment or flat number where relevant. A house name may be used instead of a number.

AddressDoctor’s new address validation software for Ireland is able to verify and correct those addresses built on a database containing almost 59,000 locality names and more than one million addresses. This enhancement will help customers ensure that mailings and shipments are correctly addressed in order to reach their destination in Ireland.

Irish mailing addresses are composed of the following elements:

  • Company or individual's name
  • House name (where applicable)
  • Street Address (including house number where applicable)
  • Town (prefix the town with "IE" if item is mailed within Europe)
  • County (not required for cities or county towns)
  • IRELAND (not required where town name is prefixed with "IE" and item is mailed within Europe)

Example of an Irish Address Format:
The Avalon Hotel
IE DUBLIN 4 -> Dublin and Cork use a 1 or 2 digit zone number.

What does "locality level data" mean?

Reference databases used by AddressDoctor can vary greatly in terms of data depth. Street and house number level data for numerous countries is available to AddressDoctor. This means that AddressDoctor verifies and - if necessary – corrects - street and house number data in an address. In ambiguous cases, for example an incorrect postal code or a locality name, the right address can be determined by means of the street information.

Some countries do not provide detailed address information because of their delivery system or internal structure. In these cases, AddressDoctor can still check addresses by locality and, if applicable, by postal codes. Elements for those addresses, where no reference file is available, are provided with the output-file.
In some countries, like in Kenya or the United Arab Emirates, mail is only delivered to post boxes. In these cases, there is no greater data depth necessary for standard delivery.

Independent from the reference data, AddressDoctor can always check input files with respect to their address format. By parsing an address, individual parts are identified in order to place them in the right place in the output file.

Our Opens internal link in current window country list shows the reference data depth for every country supported by AddressDoctor.

Where does the AddressDoctor reference data come from?

In most cases the reference data comes directly from the postal organizations of a country. If this isn't possible, other data suppliers like telecommunication organizations, direct marketing companies, or cartographic offices are consulted.

How do I obtain new databases?

Registered customers may download updated databases in our Opens internal link in current windowdownload section.

What is the size of the AddressDoctor reference database?

The total size of the reference database (world coverage for address validation and geo-coding) is currently approximately32 GB (as of October 2013). This size is for the more than 240 supported countries and territories, including any CERTIFIED data, supplementary data, and geo-coding databases. As we continuously improve our database this size is likely to grow over time.

Can we extract the postal reference data from the databases?

The postal reference data cannot be extracted from AddressDoctor's reference database, this is due to licensing restrictions with our postal carriers.

How often is the AddressDoctor database updated?

Updates are available bi-annually, quarterly and monthly. The update frequency depends on the product purchased.  Update frequencies can be found on our Opens internal link in current windowcountries & data page.

Are the reference data bases for address cleansing and geocoding identical?

No, the reference databases are not identical. The reference databases are designed for their specific purposes and thus are provided by different organizations; they differ in their design, data format and contents.