You can configure regions, countries, and country subdivisions in your marketplace and seller settings when creating a seller (via the Create Seller request) or when editing the seller's settings.

These settings allow the service to apply taxability logic based on geographic hierarchies.

Geographic hierarchy

The service organizes locations using a region→country→subdivision (state/province) hierarchical structure.

ISO codes

The service uses ISO 3166 codes to identify regions, countries, and subdivisions. You use these codes to configure your hierarchical structure. For details, refer to the list of country codes and codes for their subdivisions.

Regions and countries

Some countries, like Norway, are both regions and countries. Region definitions help apply shared taxability logic across multiple countries. You can define settings at both levels.

The service supports the following regions and countries:

Region	Countries
Australia (AU)	Australia (AU)
European Union (EU)	Austria (AT), Belgium (BE), Bulgaria (BG), Croatia (HR), Cyprus (CY), Czechia (CZ), Denmark (DK), Estonia (EE), Finland (FI), France (FR), Germany (DE), Greece (GR), Hungary (HU), Ireland (IE), Italy (IT), Latvia (LV), Lithuania (LT), Luxembourg (LU), Malta (MT), Netherlands (NL), Poland (PL), Portugal (PT), Romania (RO), Slovakia (SK), Slovenia (SI), Spain (ES), Sweden (SE)
Great Britain (GB)	Great Britain (GB)
New Zealand (NZ)	New Zealand (NZ)
Norway (NO)	Norway (NO)
Switzerland/Lichtenstein (CHLI)	Switzerland (CH) and Liechtenstein (LI)
United States (US)	United States (US)

Countries and country subdivisions

You can use ISO 3166 codes for subdivisions. For example, you can use US-PA for Pennsylvania. You can also use the subdivision abbreviation, for example, PA for Pennsylvania, if you prefer.

The service supports subdivisions for the following countries:

Country	Country Subdivisions
Canada (CA)	Alberta (CA-AB), British Columbia (CA-BC), Manitoba (CA-MB), New Brunswick (CA-NB), Newfoundland and Labrador (CA-NL), Northwest Territories (CA-NT), Nova Scotia (CA-NS), Nunavut (CA-NU), Ontario (CA-ON), Prince Edward Island (CA-PE), Quebec (CA-QC), Saskatchewan (CA-SK), Yukon (CA-YT)
Great Britain (GB)	Northern Ireland (GB-NIR)
India (IN)	Andaman and Nicobar Islands (IN-AN), Andhra Pradesh (IN-AP), Arunachal Pradesh (IN-AR), Assam (IN-AS), Bihar (IN-BR), Chandigarh (IN-CH), Chhattisgarh (IN-CG), Dadra and Nagar Haveli (IN-DN), Dādra and Nagar Haveli and Damān and Diu (IN-DH), Delhi (IN-DL), Goa (IN-GA), Gujarat (IN-GJ), Haryana (IN-HR), Himachal Pradesh (IN-HP), Jammu and Kashmir (IN-JK), Jharkhand (IN-JH), Karnataka (IN-KA), Kerala (IN-KL), Ladakh (IN-LA), Lakshadweep (IN-LD), Madhya Pradesh (IN-MP), Maharashtra (IN-MH), Manipur (IN-MN), Meghalaya (IN-ML), Mizoram (IN-MZ), Nagaland (IN-NL), Odisha (IN-OD), Puducherry (IN-PY), Punjab (IN-PB), Rajasthan (IN-RJ), Sikkim (IN-SK), Tamil Nadu (IN-TN), Telangana (IN-TS), Tripura (IN-TR), Uttar Pradesh (IN-UP), Uttarakhand (IN-UK), West Bengal (IN-WB)
United Arab Emirates (AE)	Abu Dhabi (AE-AZ), Ajman (AE-AJ), Dubai (AE-DU), Fujairah (AE-FU), Ras Al Khaimah (AE-RK), Sharjah (AE-SH), Umm Al Quwain (AE-UQ)
United States (US)	Alabama (US-AL), Alaska (US-AK), Arizona (US-AZ), Arkansas (US-AR), Armed Forces Americas excluding Canada (US-AA), Armed Forces Europe, the Middle East, Africa, and Canada (US-AE), Armed Forces Pacific (US-AP), California (US-CA), Colorado (US-CO), Connecticut (US-CT), Delaware (US-DE), District of Columbia (US-DC), Florida (US-FL), Georgia (US-GA), Hawaii (US-HI), Idaho (US-ID), Illinois (US-IL), Indiana (US-IN), Iowa (US-IA), Kansas (US-KS), Kentucky (US-KY), Louisiana (US-LA), Maine (US-ME), Maryland (US-MD), Massachusetts (US-MA), Michigan (US-MI), Minnesota (US-MN), Mississippi (US-MS), Missouri (US-MO), Montana (US-MT), Nebraska (US-NE), Nevada (US-NV), New Hampshire (US-NH), New Jersey (US-NJ), New Mexico (US-NM), New York (US-NY), North Carolina (US-NC), North Dakota (US-ND), Ohio (US-OH), Oklahoma (US-OK), Oregon (US-OR), Pennsylvania (US-PA), Puerto Rico (US-PR), Rhode Island (US-RI), South Carolina (US-SC), South Dakota (US-SD), Tennessee (US-TN), Texas (US-TX), Vermont (US-VT), Virginia (US-VA), Virgin Islands (US-VI), Washington (US-WA), West Virginia (US-WV), Wisconsin (US-WI), Wyoming (US-WY)

Subdivision codes can be used in your settings as well as in the following API fields:

billing_address
payment_address
ship_to_address
ship_from_address

Restrictions

Consider the following restrictions when defining countries, regions, and subdivisions:

European Union (EU) countries—Specify the region in most cases. If you need to indicate that a seller is registered in a specific country (using the is_seller_registered setting), also configure a country-level setting.
Non-European Union (EU) countries—Specify the country as both a country and a region. For example, for the United Kingdom (UK), for Great Britain (GB), configure Great Britain (GB) as both the country and the region.
Countries with subdivisions—Specify subdivisions (states/provinces) when you need them to model your sellers. For example, if a seller’s tax registration is specific to a Canadian province, configure the corresponding subdivision and apply the setting at that level.
Northern Ireland—Northern Ireland (NI) is part of the Great Britain (GB) region and country. If you need to apply settings specifically for Northern Ireland (NI)—for example, when a seller is registered there—configure Northern Ireland (NI) as a subdivision of Great Britain (GB).