Unify and manage your data

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.

Special Handling for GB (United Kingdom)

For addresses in the United Kingdom (GB), the AdministrativeAreaISO2 value is based on the former postal counties defined by Royal Mail, which have been declared static (see page 70 of the Royal Mail Programmer's Guide).

This means that for some regions, the administrative area returned may not reflect recent governmental changes. For example:

  • North Northamptonshire and West Northamptonshire return the administrative area as Northamptonshire (GB-NTH) instead of their individual unitary authority names.

This behavior ensures consistency with Royal Mail's official postal references but may differ from current local government structures.

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 CodeCountry Name
ADAndorra
AEUnited Arab Emirates
AFAfghanistan
AGAntigua and Barbuda
ALAlbania
AMArmenia
AOAngola
ARArgentina
ATAustria
AUAustralia
AZAzerbaijan
BDBangladesh
BEBelgium
BFBurkina Faso
BGBulgaria
BIBurundi
BJBenin
BNBrunei Darussalam
BQBonaire, Sint Eustatius and Saba
BRBrazil
BSBahamas
BTBhutan
BWBotswana
BYBelarus
BZBelize
CACanada
CGCongo
CHSwitzerland
CICôte d'Ivoire
CLChile
CNChina
COColombia
CRCosta Rica
CUCuba
CVCabo Verde
CYCyprus
CZCzechia
DEGermany
DJDjibouti
DKDenmark
DMDominica
DODominican Republic
DZAlgeria
ECEcuador
EEEstonia
EGEgypt
EREritrea
ESSpain
ETEthiopia
FIFinland
FJFiji
FRFrance
GAGabon
GB*United Kingdom of Great Britain and Northern Ireland

* see Special Handling for GB (United Kingdom)

GDGrenada
GEGeorgia
GHGhana
GLGreenland
GMGambia
GNGuinea
GQEquatorial Guinea
GRGreece
GTGuatemala
GWGuinea-Bissau
GYGuyana
HNHonduras
HRCroatia
HTHaiti
HUHungary
IDIndonesia
IEIreland
ILIsrael
INIndia
IQIraq
IRIran (Islamic Republic of)
ISIceland
ITItaly
JMJamaica
JOJordan
JPJapan
KEKenya
KGKyrgyzstan
KHCambodia
KMComoros
KNSaint Kitts and Nevis
KPKorea (Democratic People's Republic of)
KRKorea, Republic of
KWKuwait
KZKazakhstan
LALao People's Democratic Republic
LBLebanon
LILiechtenstein
LKSri Lanka
LRLiberia
LSLesotho
LTLithuania
LULuxembourg
LVLatvia
LYLibya
MDMoldova, Republic of
MEMontenegro
MMMyanmar
MNMongolia
MUMauritius
MVMaldives
MWMalawi
MXMexico
MYMalaysia
MZMozambique
NANamibia
NGNigeria
NINicaragua
NLNetherlands
NONorway
NPNepal
NRNauru
NZNew Zealand
OMOman
PAPanama
PEPeru
PGPapua New Guinea
PHPhilippines
PKPakistan
PLPoland
PTPortugal
PYParaguay
QAQatar
RORomania
RSSerbia
RURussian Federation
SASaudi Arabia
SBSolomon Islands
SCSeychelles
SDSudan
SESweden
SHSaint Helena, Ascension and Tristan da Cunha
SKSlovakia
SMSan Marino
SNSenegal
SOSomalia
SRSuriname
SSSouth Sudan
SVEl Salvador
SYSyrian Arab Republic
SZEswatini
TDChad
THThailand
TJTajikistan
TLTimor-Leste
TMTurkmenistan
TNTunisia
TOTonga
TRTurkey
TTTrinidad and Tobago
TVTuvalu
TWTaiwan, Province of China
TZTanzania, United Republic of
UAUkraine
UGUganda
USUnited States of America
UYUruguay
UZUzbekistan
VCSaint Vincent and the Grenadines
VEVenezuela (Bolivarian Republic of)
VNViet Nam
VUVanuatu
WSSamoa
YEYemen
ZASouth Africa
ZMZambia
ZWZimbabwe