Enhance/ISO2 Administrative Area Codes

Learn more about enriching address data with ISO-compliant Administrative area codes.

The purpose of ISO 3166-2 is to establish an international standard of short and unique alphanumeric codes to represent the relevant administrative divisions and dependent territories of all countries in a more convenient and less ambiguous form than their full names.

You can configure the address cleanser on your tenant to run address verification requests using the Enhance process. Enhance is designed to obtain additional attributes that relate to the address fields in the output of the verification process. When active, the Enhance process enriches the data that is returned by the output/response from the cleanser in several different ways. For more information, see Address Cleanse Options.

To enable the Enhance process, add e to the chain of values related to the process configuration setting for the cleanser.

Appending ISO-compliant administrative area data is one way Enhance can enrich address verification results. It adds additional attributes to the output of the verification process. The following fields are available through the Enhance process output:
  • AdministrativeAreaISO2 - The value returned in the AdministrativeAreaISO2 consists of two parts, separated by a hyphen.
    1. The first part is the ISO 3166-1 alpha-2 code of the address’ country.
    2. The second part is the ISO 3166-2 value for the administrative area where the address is located.

      For example, the value for the state of California in the United States is: US-CA

  • AdministrativeAreaISO2Status - The Address Cleanser will also return a field status for AdministrativeAreaISO2. For a valid code, the field status is: fsAdded.

Coverage

ISO 3166-2 values for administrative areas are now available for 171 countries in total. The following table lists all the ISO 3166-1 Country Codes that support ISO 3166-2 values:
Table 1. Supported ISO 3166-1 Country Codes
ISO 3166-1 Country Code Country Name
AD Andorra
AE United Arab Emirates
AF Afghanistan
AG Antigua and Barbuda
AL Albania
AM Armenia
AO Angola
AR Argentina
AT Austria
AU Australia
AZ Azerbaijan
BD Bangladesh
BE Belgium
BF Burkina Faso
BG Bulgaria
BI Burundi
BJ Benin
BN Brunei Darussalam
BQ Bonaire, Sint Eustatius and Saba
BR Brazil
BS Bahamas
BT Bhutan
BW Botswana
BY Belarus
BZ Belize
CA Canada
CG Congo
CH Switzerland
CI Côte d'Ivoire
CL Chile
CN China
CO Colombia
CR Costa Rica
CU Cuba
CV Cabo Verde
CY Cyprus
CZ Czechia
DE Germany
DJ Djibouti
DK Denmark
DM Dominica
DO Dominican Republic
DZ Algeria
EC Ecuador
EE Estonia
EG Egypt
ER Eritrea
ES Spain
ET Ethiopia
FI Finland
FJ Fiji
FR France
GA Gabon
GB United Kingdom of Great Britain and Northern Ireland
GD Grenada
GE Georgia
GH Ghana
GL Greenland
GM Gambia
GN Guinea
GQ Equatorial Guinea
GR Greece
GT Guatemala
GW Guinea-Bissau
GY Guyana
HN Honduras
HR Croatia
HT Haiti
HU Hungary
ID Indonesia
IE Ireland
IL Israel
IN India
IQ Iraq
IR Iran (Islamic Republic of)
IS Iceland
IT Italy
JM Jamaica
JO Jordan
JP Japan
KE Kenya
KG Kyrgyzstan
KH Cambodia
KM Comoros
KN Saint Kitts and Nevis
KP Korea (Democratic People's Republic of)
KR Korea, Republic of
KW Kuwait
KZ Kazakhstan
LA Lao People's Democratic Republic
LB Lebanon
LI Liechtenstein
LK Sri Lanka
LR Liberia
LS Lesotho
LT Lithuania
LU Luxembourg
LV Latvia
LY Libya
MD Moldova, Republic of
ME Montenegro
MM Myanmar
MN Mongolia
MU Mauritius
MV Maldives
MW Malawi
MX Mexico
MY Malaysia
MZ Mozambique
NA Namibia
NG Nigeria
NI Nicaragua
NL Netherlands
NO Norway
NP Nepal
NR Nauru
NZ New Zealand
OM Oman
PA Panama
PE Peru
PG Papua New Guinea
PH Philippines
PK Pakistan
PL Poland
PT Portugal
PY Paraguay
QA Qatar
RO Romania
RS Serbia
RU Russian Federation
SA Saudi Arabia
SB Solomon Islands
SC Seychelles
SD Sudan
SE Sweden
SH Saint Helena, Ascension and Tristan da Cunha
SK Slovakia
SM San Marino
SN Senegal
SO Somalia
SR Suriname
SS South Sudan
SV El Salvador
SY Syrian Arab Republic
SZ Eswatini
TD Chad
TH Thailand
TJ Tajikistan
TL Timor-Leste
TM Turkmenistan
TN Tunisia
TO Tonga
TR Turkey
TT Trinidad and Tobago
TV Tuvalu
TW Taiwan, Province of China
TZ Tanzania, United Republic of
UA Ukraine
UG Uganda
US United States of America
UY Uruguay
UZ Uzbekistan
VC Saint Vincent and the Grenadines
VE Venezuela (Bolivarian Republic of)
VN Viet Nam
VU Vanuatu
WS Samoa
YE Yemen
ZA South Africa
ZM Zambia
ZW Zimbabwe