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.
AdministrativeAreaISO2- The value returned in the AdministrativeAreaISO2 consists of two parts, separated by a hyphen.- The first part is the ISO 3166-1 alpha-2 code of the address’ country.
- 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-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 |