Regions, Countries and Country Subdivisions
Regions, countries and subdivisions can be defined in your marketplace and seller settings.
These can attached to the Create Seller request when a seller is created or they can be used when editing the seller's settings.
You can specify regions, countries and country subdivisions. Generally, countries inherit settings from regions and subdivisions from countries. However, there are exceptions to this.
Restrictions
- For non-EU countries, you must define the country as both a country and region. For example, for the UK, you would define GB as both a country and region.
- For the EU, it is sufficient to specify the region alone. However, if a seller is registered in a country and you want to specify this (using the
is_seller_registered
setting), you must create the country. - For countries like Canada who have subdivisions, you must specify the subdivisions if you require them to model your sellers. For example, if you have sellers registered there. For example, if your seller's tax number is specific to a province, you need to create the subdivision and add the setting there.
- Northern Ireland is included in the region and country Great Britain (GB) for digital goods. if you require settings for Northern Ireland, for example if a seller is registered there, you must define NI as a subdivision of GB.
- Regions and countries are automatically associated. For example, you do not have to nest the EU member states in the EU region in the request body.
Region Codes
You use the ISO codes to build your hierarchy of regions, countries and subdivisions.
Regions and Countries
Some countries like Norway are both a region and a country. You can define settings at both levels.
Region | Countries |
---|---|
European Union (EU) | Austria, Belgium, Bulgaria, Croatia, Republic of Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, and Sweden. |
United States (US) | United States (US) |
Great Britain (GB) | Great Britain (GB) |
Norway (NO) | Norway (NO) |
Australia (AU) | Australia (AU) |
New Zealand (NZ) | New Zealand (NZ) |
Countries and Country Subdivisions
You can use ISO codes for country subdivisions. For example, you can use US-TX
for Texas. You can also use just the subdivision name, for example TX
if you prefer.
You can define subdivisions for the following countries;
- Canada (CA)
- India (IN)
- United Arab Emirates (AE)
- Unted States of America (USA)
The subdivision values can be used in your settings as well as in the following API fields:
billing_address
payment_address
ship_to_address
ship_from_address
The following table lists the supported subdivisions:
Country | Country Subdivision |
---|---|
United States (US) | Armed Forces Americas excluding Canada (US-AA), Armed Forces Europe, the Middle East, Africa, and Canada ,(US-AE), Alabama (US-AL), Armed Forces Pacific (US-AP)Alaska (US-AK), Arizona (US-AZ), (US-AS), Arkansas (US-AR), (US-AS), 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) |
Great Britain (GB) | Northern Ireland (GB-NIR) |
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). |
India (IN) | Andaman and Nicobar Islands (IN-AN), Andhra Pradesh (IN-AP), Arunachal Pradesh (IN-AP), Assam (IN-AS), Bihar (IN-BR), Chandigarh (IN-CH), Chhattisgarh (IN-CT), Dadra and Nagar Haveli (IN-DN), Daman and Diu (IN-DD), 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), Lakshadweep (IN-LD), Madhya Pradesh (IN-MP), Maharashtra (IN-MH), Manipur (IN-MN), Meghalaya (IN-ML), Mizoram (IN-MZ), Nagaland (IN-NL), Odisha (IN-OR), Puducherry (IN-PY), Punjab (IN-PB), Rajastan (IN-RJ), Sikkim (IN-SK), Tamil Nadu (IN-TN), Telangana (IN-TG), Tripura (IN-TR), Uttar Pradesh (IN-UP), Uttarakhand (IN-UT), West Bengal (IN-WB). |
United Arab Emirates (AE) | Ajman (AE-AJ), Abu Dhabi (AE-AZ), Dubai (AE-DU), Fujairah (AE-FU), Ras Al Khaimah (AE-RK), Sharjah (AE-SH), Umm Al Quwain (AE-UQ). |
In this Section
Topic | Description |
---|---|
Regions, Countries and Country Subdivisions | Overview of how these entities are modelled. |
US Military Addresses | You may wish to define the country subdivision codes that represent United States of America (USA) military addresses, to facilitate US-based sales. |
Countries where No Tax Information is Returned | Read about countries where no tax information is returned. |
Updated 17 days ago