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.

RegionCountries
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:

CountryCountry 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

TopicDescription
Regions, Countries and Country SubdivisionsOverview of how these entities are modelled.
US Military AddressesYou 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 ReturnedRead about countries where no tax information is returned.