country

This class provides RESTful services to get countries or regions and states or provinces information.

Handler Class:

com.ibm.commerce.rest.store.handler.CountryHandler

Method Summary

HTTP MethodPathDescription
GET/store/{storeId}/country/country_state_listRetrieve a list of countries/region and corresponding states/provinces.
GET/store/{storeId}/country/country_state_nameRetrieve the display name of a country and/or a state.

Method Details

GET /store/{storeId}/country/country_state_list

Retrieve a list of countries/region and corresponding states/provinces.

Handler Method:

findCountryStateList

Secure Call Mandatory:

false

Partial Authentication Allowed:

false

Parameters:
NameDescriptionParameter TypeData TypeRequiredAllow Multiple
storeIdThe store identifier.pathstringtrueN/A
profileNameProfile name. Profiles determine the subset of data to be returned by a query. Default profile name = IBM_countryStateList_Summaryquerystringfalsefalse
countryCodeThe country or region abbreviation codequerystringfalsefalse
HTTP Status Codes:
HTTP Status CodeDescription
200The requested completed successfully.
400Bad request. Some of the inputs provided to the request aren't valid.
401Not authenticated. The user session isn't valid.
403The user isn't authorized to perform the specified request.
500Internal server error. Additional details will be contained on the server logs.
Response Data Type:

com.ibm.commerce.user.beans.CountryStateListDataBean_IBM_countryStateList_Summary


Example

Request:
GET /wcs/resources/store/10001/country/country_state_list?countryCode=&langId=-1&responseFormat=json
HTTP Status Code:

200

Response:
{
	"countries": [
		{
			"callingCode": "+93",
			"code": "AF",
			"displayName": "Afghanistan",
			"states": [
			]
		},
		{
			"callingCode": "+355",
			"code": "AL",
			"displayName": "Albania",
			"states": [
			]
		},
		{
			"callingCode": "+213",
			"code": "DZ",
			"displayName": "Algeria",
			"states": [
			]
		},
		{
			"callingCode": "+684",
			"code": "AS",
			"displayName": "American Samoa",
			"states": [
			]
		},
		{
			"callingCode": "+376",
			"code": "AD",
			"displayName": "Andorra",
			"states": [
			]
		},
		{
			"callingCode": "+244",
			"code": "AO",
			"displayName": "Angola",
			"states": [
			]
		},
		{
			"callingCode": "+1-264",
			"code": "AI",
			"displayName": "Anguilla",
			"states": [
			]
		},
		{
			"callingCode": "+672",
			"code": "AQ",
			"displayName": "Antarctica",
			"states": [
			]
		},
		{
			"callingCode": "+1-268",
			"code": "AG",
			"displayName": "Antigua and Barbuda",
			"states": [
			]
		},
		{
			"callingCode": "+54",
			"code": "AR",
			"displayName": "Argentina",
			"states": [
			]
		},
		{
			"callingCode": "+374",
			"code": "AM",
			"displayName": "Armenia",
			"states": [
			]
		},
		{
			"callingCode": "+297",
			"code": "AW",
			"displayName": "Aruba",
			"states": [
			]
		},
		{
			"callingCode": "+61",
			"code": "AU",
			"displayName": "Australia",
			"states": [
			]
		},
		{
			"callingCode": "+43",
			"code": "AT",
			"displayName": "Austria",
			"states": [
			]
		},
		{
			"callingCode": "+994",
			"code": "AZ",
			"displayName": "Azerbaijan",
			"states": [
			]
		},
		{
			"callingCode": "+1-242",
			"code": "BS",
			"displayName": "Bahamas",
			"states": [
			]
		},
		{
			"callingCode": "+973",
			"code": "BH",
			"displayName": "Bahrain",
			"states": [
			]
		},
		{
			"callingCode": "+880",
			"code": "BD",
			"displayName": "Bangladesh",
			"states": [
			]
		},
		{
			"callingCode": "+1-246",
			"code": "BB",
			"displayName": "Barbados",
			"states": [
			]
		},
		{
			"callingCode": "+375",
			"code": "BY",
			"displayName": "Belarus",
			"states": [
			]
		},
		{
			"callingCode": "+32",
			"code": "BE",
			"displayName": "Belgium",
			"states": [
			]
		},
		{
			"callingCode": "+501",
			"code": "BZ",
			"displayName": "Belize",
			"states": [
			]
		},
		{
			"callingCode": "+229",
			"code": "BJ",
			"displayName": "Benin",
			"states": [
			]
		},
		{
			"callingCode": "+1-441",
			"code": "BM",
			"displayName": "Bermuda",
			"states": [
			]
		},
		{
			"callingCode": "+975",
			"code": "BT",
			"displayName": "Bhutan",
			"states": [
			]
		},
		{
			"callingCode": "+591",
			"code": "BO",
			"displayName": "Bolivia",
			"states": [
			]
		},
		{
			"callingCode": "+387",
			"code": "BA",
			"displayName": "Bosnia and Herzegovina",
			"states": [
			]
		},
		{
			"callingCode": "+267",
			"code": "BW",
			"displayName": "Botswana",
			"states": [
			]
		},
		{
			"callingCode": "",
			"code": "BV",
			"displayName": "Bouvet Island",
			"states": [
			]
		},
		{
			"callingCode": "+55",
			"code": "BR",
			"displayName": "Brazil",
			"states": [
			]
		},
		{
			"callingCode": "+246",
			"code": "IO",
			"displayName": "British Indian Ocean Territory",
			"states": [
			]
		},
		{
			"callingCode": "+673",
			"code": "BN",
			"displayName": "Brunei",
			"states": [
			]
		},
		{
			"callingCode": "+359",
			"code": "BG",
			"displayName": "Bulgaria",
			"states": [
			]
		},
		{
			"callingCode": "+226",
			"code": "BF",
			"displayName": "Burkina Faso",
			"states": [
			]
		},
		{
			"callingCode": "+257",
			"code": "BI",
			"displayName": "Burundi",
			"states": [
			]
		},
		{
			"callingCode": "+855",
			"code": "KH",
			"displayName": "Cambodia",
			"states": [
			]
		},
		{
			"callingCode": "+237",
			"code": "CM",
			"displayName": "Cameroon",
			"states": [
			]
		},
		{
			"callingCode": "+1",
			"code": "CA",
			"displayName": "Canada",
			"states": [
				{
					"code": "AB",
					"displayName": "Alberta"
				},
				{
					"code": "BC",
					"displayName": "British Columbia"
				},
				{
					"code": "MB",
					"displayName": "Manitoba"
				},
				{
					"code": "NB",
					"displayName": "New Brunswick"
				},
				{
					"code": "NL",
					"displayName": "Newfoundland"
				},
				{
					"code": "NT",
					"displayName": "Northwest Territory"
				},
				{
					"code": "NS",
					"displayName": "Nova Scotia"
				},
				{
					"code": "NU",
					"displayName": "Nunavut"
				},
				{
					"code": "ON",
					"displayName": "Ontario"
				},
				{
					"code": "PE",
					"displayName": "Prince Edward Island"
				},
				{
					"code": "QC",
					"displayName": "Quebec"
				},
				{
					"code": "SK",
					"displayName": "Saskatchewan"
				},
				{
					"code": "YT",
					"displayName": "Yukon"
				}
			]
		},
		{
			"callingCode": "+238",
			"code": "CV",
			"displayName": "Cape Verde",
			"states": [
			]
		},
		{
			"callingCode": "+1-345",
			"code": "KY",
			"displayName": "Cayman Islands",
			"states": [
			]
		},
		{
			"callingCode": "+236",
			"code": "CF",
			"displayName": "Central African Republic",
			"states": [
			]
		},
		{
			"callingCode": "+235",
			"code": "TD",
			"displayName": "Chad",
			"states": [
			]
		},
		{
			"callingCode": "+56",
			"code": "CL",
			"displayName": "Chile",
			"states": [
			]
		},
		{
			"callingCode": "+86",
			"code": "CN",
			"displayName": "China",
			"states": [
			]
		},
		{
			"callingCode": "+61-8",
			"code": "CX",
			"displayName": "Christmas Island",
			"states": [
			]
		},
		{
			"callingCode": "+61",
			"code": "CC",
			"displayName": "Cocos Islands",
			"states": [
			]
		},
		{
			"callingCode": "+57",
			"code": "CO",
			"displayName": "Colombia",
			"states": [
			]
		},
		{
			"callingCode": "+269",
			"code": "KM",
			"displayName": "Comoros",
			"states": [
			]
		},
		{
			"callingCode": "+242",
			"code": "CG",
			"displayName": "Congo",
			"states": [
			]
		},
		{
			"callingCode": "+243",
			"code": "CD",
			"displayName": "Congo, Democratic Republic of the",
			"states": [
			]
		},
		{
			"callingCode": "+682",
			"code": "CK",
			"displayName": "Cook Islands",
			"states": [
			]
		},
		{
			"callingCode": "+506",
			"code": "CR",
			"displayName": "Costa Rica",
			"states": [
			]
		},
		{
			"callingCode": "+225",
			"code": "CI",
			"displayName": "Cote d'Ivoire",
			"states": [
			]
		},
		{
			"callingCode": "+385",
			"code": "HR",
			"displayName": "Croatia",
			"states": [
			]
		},
		{
			"callingCode": "+53",
			"code": "CU",
			"displayName": "Cuba",
			"states": [
			]
		},
		{
			"callingCode": "+357",
			"code": "CY",
			"displayName": "Cyprus",
			"states": [
			]
		},
		{
			"callingCode": "+420",
			"code": "CZ",
			"displayName": "Czech Republic",
			"states": [
			]
		},
		{
			"callingCode": "+45",
			"code": "DK",
			"displayName": "Denmark",
			"states": [
			]
		},
		{
			"callingCode": "+253",
			"code": "DJ",
			"displayName": "Djibouti",
			"states": [
			]
		},
		{
			"callingCode": "+1-767",
			"code": "DM",
			"displayName": "Dominica",
			"states": [
			]
		},
		{
			"callingCode": "+1-809",
			"code": "DO",
			"displayName": "Dominican Republic",
			"states": [
			]
		},
		{
			"callingCode": "+670",
			"code": "TP",
			"displayName": "East Timor",
			"states": [
			]
		},
		{
			"callingCode": "+593",
			"code": "EC",
			"displayName": "Ecuador",
			"states": [
			]
		},
		{
			"callingCode": "+20",
			"code": "EG",
			"displayName": "Egypt",
			"states": [
			]
		},
		{
			"callingCode": "+503",
			"code": "SV",
			"displayName": "El Salvador",
			"states": [
			]
		},
		{
			"callingCode": "+240",
			"code": "GQ",
			"displayName": "Equatorial Guinea",
			"states": [
			]
		},
		{
			"callingCode": "+291",
			"code": "ER",
			"displayName": "Eritrea",
			"states": [
			]
		},
		{
			"callingCode": "+372",
			"code": "EE",
			"displayName": "Estonia",
			"states": [
			]
		},
		{
			"callingCode": "+251",
			"code": "ET",
			"displayName": "Ethiopia",
			"states": [
			]
		},
		{
			"callingCode": "+500",
			"code": "FK",
			"displayName": "Falkland Islands",
			"states": [
			]
		},
		{
			"callingCode": "+298",
			"code": "FO",
			"displayName": "Faroe Islands",
			"states": [
			]
		},
		{
			"callingCode": "+679",
			"code": "FJ",
			"displayName": "Fiji",
			"states": [
			]
		},
		{
			"callingCode": "+358",
			"code": "FI",
			"displayName": "Finland",
			"states": [
			]
		},
		{
			"callingCode": "+33",
			"code": "FR",
			"displayName": "France",
			"states": [
			]
		},
		{
			"callingCode": "+594",
			"code": "GF",
			"displayName": "French Guiana",
			"states": [
			]
		},
		{
			"callingCode": "+689",
			"code": "PF",
			"displayName": "French Polynesia",
			"states": [
			]
		},
		{
			"callingCode": "",
			"code": "TF",
			"displayName": "French Southern Territories",
			"states": [
			]
		},
		{
			"callingCode": "+241",
			"code": "GA",
			"displayName": "Gabon",
			"states": [
			]
		},
		{
			"callingCode": "+220",
			"code": "GM",
			"displayName": "Gambia",
			"states": [
			]
		},
		{
			"callingCode": "+995",
			"code": "GE",
			"displayName": "Georgia",
			"states": [
			]
		},
		{
			"callingCode": "+49",
			"code": "DE",
			"displayName": "Germany",
			"states": [
			]
		},
		{
			"callingCode": "+233",
			"code": "GH",
			"displayName": "Ghana",
			"states": [
			]
		},
		{
			"callingCode": "+350",
			"code": "GI",
			"displayName": "Gibraltar",
			"states": [
			]
		},
		{
			"callingCode": "+30",
			"code": "GR",
			"displayName": "Greece",
			"states": [
			]
		},
		{
			"callingCode": "+299",
			"code": "GL",
			"displayName": "Greenland",
			"states": [
			]
		},
		{
			"callingCode": "+1-473",
			"code": "GD",
			"displayName": "Grenada",
			"states": [
			]
		},
		{
			"callingCode": "+590",
			"code": "GP",
			"displayName": "Guadeloupe",
			"states": [
			]
		},
		{
			"callingCode": "+1-671",
			"code": "GU",
			"displayName": "Guam",
			"states": [
			]
		},
		{
			"callingCode": "+502",
			"code": "GT",
			"displayName": "Guatemala",
			"states": [
			]
		},
		{
			"callingCode": "+224",
			"code": "GN",
			"displayName": "Guinea",
			"states": [
			]
		},
		{
			"callingCode": "+245",
			"code": "GW",
			"displayName": "Guinea-Bissau",
			"states": [
			]
		},
		{
			"callingCode": "+592",
			"code": "GY",
			"displayName": "Guyana",
			"states": [
			]
		},
		{
			"callingCode": "+509",
			"code": "HT",
			"displayName": "Haiti",
			"states": [
			]
		},
		{
			"callingCode": "",
			"code": "HM",
			"displayName": "Heard Island and Mcdonald Islands",
			"states": [
			]
		},
		{
			"callingCode": "+379",
			"code": "VA",
			"displayName": "Holy See",
			"states": [
			]
		},
		{
			"callingCode": "+504",
			"code": "HN",
			"displayName": "Honduras",
			"states": [
			]
		},
		{
			"callingCode": "+852",
			"code": "HK",
			"displayName": "Hong Kong S.A.R. of China",
			"states": [
			]
		},
		{
			"callingCode": "+36",
			"code": "HU",
			"displayName": "Hungary",
			"states": [
			]
		},
		{
			"callingCode": "+354",
			"code": "IS",
			"displayName": "Iceland",
			"states": [
			]
		},
		{
			"callingCode": "+91",
			"code": "IN",
			"displayName": "India",
			"states": [
			]
		},
		{
			"callingCode": "+62",
			"code": "ID",
			"displayName": "Indonesia",
			"states": [
			]
		},
		{
			"callingCode": "+98",
			"code": "IR",
			"displayName": "Iran",
			"states": [
			]
		},
		{
			"callingCode": "+964",
			"code": "IQ",
			"displayName": "Iraq",
			"states": [
			]
		},
		{
			"callingCode": "+353",
			"code": "IE",
			"displayName": "Ireland",
			"states": [
			]
		},
		{
			"callingCode": "+972",
			"code": "IL",
			"displayName": "Israel",
			"states": [
			]
		},
		{
			"callingCode": "+39",
			"code": "IT",
			"displayName": "Italy",
			"states": [
			]
		},
		{
			"callingCode": "+1-876",
			"code": "JM",
			"displayName": "Jamaica",
			"states": [
			]
		},
		{
			"callingCode": "+81",
			"code": "JP",
			"displayName": "Japan",
			"states": [
				{
					"code": "Aichi",
					"displayName": "Aichi"
				},
				{
					"code": "Akita",
					"displayName": "Akita"
				},
				{
					"code": "Aomori",
					"displayName": "Aomori"
				},
				{
					"code": "Chiba",
					"displayName": "Chiba"
				},
				{
					"code": "Ehime",
					"displayName": "Ehime"
				},
				{
					"code": "Fukui",
					"displayName": "Fukui"
				},
				{
					"code": "Fukuoka",
					"displayName": "Fukuoka"
				},
				{
					"code": "Fukushima",
					"displayName": "Fukushima"
				},
				{
					"code": "Gifu",
					"displayName": "Gifu"
				},
				{
					"code": "Gunma",
					"displayName": "Gunma"
				},
				{
					"code": "Hiroshima",
					"displayName": "Hiroshima"
				},
				{
					"code": "Hokkaido",
					"displayName": "Hokkaido"
				},
				{
					"code": "Hyogo",
					"displayName": "Hyogo"
				},
				{
					"code": "Ibaraki",
					"displayName": "Ibaraki"
				},
				{
					"code": "Ishikawa",
					"displayName": "Ishikawa"
				},
				{
					"code": "Iwate",
					"displayName": "Iwate"
				},
				{
					"code": "Kagawa",
					"displayName": "Kagawa"
				},
				{
					"code": "Kagoshima",
					"displayName": "Kagoshima"
				},
				{
					"code": "Kanagawa",
					"displayName": "Kanagawa"
				},
				{
					"code": "Kochi",
					"displayName": "Kochi"
				},
				{
					"code": "Kumamoto",
					"displayName": "Kumamoto"
				},
				{
					"code": "Kyoto",
					"displayName": "Kyoto"
				},
				{
					"code": "Mie",
					"displayName": "Mie"
				},
				{
					"code": "Miyagi",
					"displayName": "Miyagi"
				},
				{
					"code": "Miyazaki",
					"displayName": "Miyazaki"
				},
				{
					"code": "Nagano",
					"displayName": "Nagano"
				},
				{
					"code": "Nagasaki",
					"displayName": "Nagasaki"
				},
				{
					"code": "Nara",
					"displayName": "Nara"
				},
				{
					"code": "Niigata",
					"displayName": "Niigata"
				},
				{
					"code": "Oita",
					"displayName": "Oita"
				},
				{
					"code": "Okayama",
					"displayName": "Okayama"
				},
				{
					"code": "Okinawa",
					"displayName": "Okinawa"
				},
				{
					"code": "Osaka",
					"displayName": "Osaka"
				},
				{
					"code": "Saga",
					"displayName": "Saga"
				},
				{
					"code": "Saitama",
					"displayName": "Saitama"
				},
				{
					"code": "Shiga",
					"displayName": "Shiga"
				},
				{
					"code": "Shimane",
					"displayName": "Shimane"
				},
				{
					"code": "Shizuoka",
					"displayName": "Shizuoka"
				},
				{
					"code": "Tochigi",
					"displayName": "Tochigi"
				},
				{
					"code": "Tokushima",
					"displayName": "Tokushima"
				},
				{
					"code": "Tokyo",
					"displayName": "Tokyo"
				},
				{
					"code": "Tottori",
					"displayName": "Tottori"
				},
				{
					"code": "Toyama",
					"displayName": "Toyama"
				},
				{
					"code": "Wakayama",
					"displayName": "Wakayama"
				},
				{
					"code": "Yamagata",
					"displayName": "Yamagata"
				},
				{
					"code": "Yamaguchi",
					"displayName": "Yamaguchi"
				},
				{
					"code": "Yamanashi",
					"displayName": "Yamanashi"
				}
			]
		},
		{
			"callingCode": "+962",
			"code": "JO",
			"displayName": "Jordan",
			"states": [
			]
		},
		{
			"callingCode": "+7-6",
			"code": "KZ",
			"displayName": "Kazakhstan",
			"states": [
			]
		},
		{
			"callingCode": "+254",
			"code": "KE",
			"displayName": "Kenya",
			"states": [
			]
		},
		{
			"callingCode": "+686",
			"code": "KI",
			"displayName": "Kiribati",
			"states": [
			]
		},
		{
			"callingCode": "+850",
			"code": "KP",
			"displayName": "Korea, North",
			"states": [
			]
		},
		{
			"callingCode": "+82",
			"code": "KR",
			"displayName": "Korea, South",
			"states": [
			]
		},
		{
			"callingCode": "+965",
			"code": "KW",
			"displayName": "Kuwait",
			"states": [
			]
		},
		{
			"callingCode": "+996",
			"code": "KG",
			"displayName": "Kyrgyzstan",
			"states": [
			]
		},
		{
			"callingCode": "+856",
			"code": "LA",
			"displayName": "Laos",
			"states": [
			]
		},
		{
			"callingCode": "+371",
			"code": "LV",
			"displayName": "Latvia",
			"states": [
			]
		},
		{
			"callingCode": "+961",
			"code": "LB",
			"displayName": "Lebanon",
			"states": [
			]
		},
		{
			"callingCode": "+266",
			"code": "LS",
			"displayName": "Lesotho",
			"states": [
			]
		},
		{
			"callingCode": "+231",
			"code": "LR",
			"displayName": "Liberia",
			"states": [
			]
		},
		{
			"callingCode": "+218",
			"code": "LY",
			"displayName": "Libya",
			"states": [
			]
		},
		{
			"callingCode": "+423",
			"code": "LI",
			"displayName": "Liechtenstein",
			"states": [
			]
		},
		{
			"callingCode": "+370",
			"code": "LT",
			"displayName": "Lithuania",
			"states": [
			]
		},
		{
			"callingCode": "+352",
			"code": "LU",
			"displayName": "Luxembourg",
			"states": [
			]
		},
		{
			"callingCode": "+853",
			"code": "MO",
			"displayName": "Macau S.A.R. of China",
			"states": [
			]
		},
		{
			"callingCode": "+389",
			"code": "MK",
			"displayName": "Macedonia",
			"states": [
			]
		},
		{
			"callingCode": "+261",
			"code": "MG",
			"displayName": "Madagascar",
			"states": [
			]
		},
		{
			"callingCode": "+265",
			"code": "MW",
			"displayName": "Malawi",
			"states": [
			]
		},
		{
			"callingCode": "+60",
			"code": "MY",
			"displayName": "Malaysia",
			"states": [
			]
		},
		{
			"callingCode": "+960",
			"code": "MV",
			"displayName": "Maldives",
			"states": [
			]
		},
		{
			"callingCode": "+223",
			"code": "ML",
			"displayName": "Mali",
			"states": [
			]
		},
		{
			"callingCode": "+356",
			"code": "MT",
			"displayName": "Malta",
			"states": [
			]
		},
		{
			"callingCode": "+692",
			"code": "MH",
			"displayName": "Marshall Islands",
			"states": [
			]
		},
		{
			"callingCode": "+596",
			"code": "MQ",
			"displayName": "Martinique",
			"states": [
			]
		},
		{
			"callingCode": "+222",
			"code": "MR",
			"displayName": "Mauritania",
			"states": [
			]
		},
		{
			"callingCode": "+230",
			"code": "MU",
			"displayName": "Mauritius",
			"states": [
			]
		},
		{
			"callingCode": "+262",
			"code": "YT",
			"displayName": "Mayotte",
			"states": [
			]
		},
		{
			"callingCode": "+52",
			"code": "MX",
			"displayName": "Mexico",
			"states": [
			]
		},
		{
			"callingCode": "+691",
			"code": "FM",
			"displayName": "Micronesia",
			"states": [
			]
		},
		{
			"callingCode": "+373",
			"code": "MD",
			"displayName": "Moldova",
			"states": [
			]
		},
		{
			"callingCode": "+377",
			"code": "MC",
			"displayName": "Monaco",
			"states": [
			]
		},
		{
			"callingCode": "+976",
			"code": "MN",
			"displayName": "Mongolia",
			"states": [
			]
		},
		{
			"callingCode": "+1-664",
			"code": "MS",
			"displayName": "Montserrat",
			"states": [
			]
		},
		{
			"callingCode": "+212",
			"code": "MA",
			"displayName": "Morocco",
			"states": [
			]
		},
		{
			"callingCode": "+258",
			"code": "MZ",
			"displayName": "Mozambique",
			"states": [
			]
		},
		{
			"callingCode": "+95",
			"code": "MM",
			"displayName": "Myanmar",
			"states": [
			]
		},
		{
			"callingCode": "+264",
			"code": "NA",
			"displayName": "Namibia",
			"states": [
			]
		},
		{
			"callingCode": "+674",
			"code": "NR",
			"displayName": "Nauru",
			"states": [
			]
		},
		{
			"callingCode": "+977",
			"code": "NP",
			"displayName": "Nepal",
			"states": [
			]
		},
		{
			"callingCode": "+31",
			"code": "NL",
			"displayName": "Netherlands",
			"states": [
			]
		},
		{
			"callingCode": "+599",
			"code": "AN",
			"displayName": "Netherlands Antilles",
			"states": [
			]
		},
		{
			"callingCode": "+687",
			"code": "NC",
			"displayName": "New Caledonia",
			"states": [
			]
		},
		{
			"callingCode": "+64",
			"code": "NZ",
			"displayName": "New Zealand",
			"states": [
			]
		},
		{
			"callingCode": "+505",
			"code": "NI",
			"displayName": "Nicaragua",
			"states": [
			]
		},
		{
			"callingCode": "+227",
			"code": "NE",
			"displayName": "Niger",
			"states": [
			]
		},
		{
			"callingCode": "+234",
			"code": "NG",
			"displayName": "Nigeria",
			"states": [
			]
		},
		{
			"callingCode": "+683",
			"code": "NU",
			"displayName": "Niue",
			"states": [
			]
		},
		{
			"callingCode": "+672",
			"code": "NF",
			"displayName": "Norfolk Island",
			"states": [
			]
		},
		{
			"callingCode": "+1-670",
			"code": "MP",
			"displayName": "Northern Mariana Islands",
			"states": [
			]
		},
		{
			"callingCode": "+47",
			"code": "NO",
			"displayName": "Norway",
			"states": [
			]
		},
		{
			"callingCode": "+968",
			"code": "OM",
			"displayName": "Oman",
			"states": [
			]
		},
		{
			"callingCode": "+92",
			"code": "PK",
			"displayName": "Pakistan",
			"states": [
			]
		},
		{
			"callingCode": "+680",
			"code": "PW",
			"displayName": "Palau",
			"states": [
			]
		},
		{
			"callingCode": "+970",
			"code": "PS",
			"displayName": "Palestinian Territory",
			"states": [
			]
		},
		{
			"callingCode": "+507",
			"code": "PA",
			"displayName": "Panama",
			"states": [
			]
		},
		{
			"callingCode": "+675",
			"code": "PG",
			"displayName": "Papua New Guinea",
			"states": [
			]
		},
		{
			"callingCode": "+595",
			"code": "PY",
			"displayName": "Paraguay",
			"states": [
			]
		},
		{
			"callingCode": "+51",
			"code": "PE",
			"displayName": "Peru",
			"states": [
			]
		},
		{
			"callingCode": "+63",
			"code": "PH",
			"displayName": "Philippines",
			"states": [
			]
		},
		{
			"callingCode": "+872",
			"code": "PN",
			"displayName": "Pitcairn",
			"states": [
			]
		},
		{
			"callingCode": "+48",
			"code": "PL",
			"displayName": "Poland",
			"states": [
			]
		},
		{
			"callingCode": "+351",
			"code": "PT",
			"displayName": "Portugal",
			"states": [
			]
		},
		{
			"callingCode": "+1-778",
			"code": "PR",
			"displayName": "Puerto Rico",
			"states": [
				{
					"code": "PR",
					"displayName": "Puerto Rico"
				}
			]
		},
		{
			"callingCode": "+974",
			"code": "QA",
			"displayName": "Qatar",
			"states": [
			]
		},
		{
			"callingCode": "+262",
			"code": "RE",
			"displayName": "Reunion",
			"states": [
			]
		},
		{
			"callingCode": "+40",
			"code": "RO",
			"displayName": "Romania",
			"states": [
			]
		},
		{
			"callingCode": "+7",
			"code": "RU",
			"displayName": "Russian Federation",
			"states": [
			]
		},
		{
			"callingCode": "+250",
			"code": "RW",
			"displayName": "Rwanda",
			"states": [
			]
		},
		{
			"callingCode": "+290",
			"code": "SH",
			"displayName": "Saint Helena",
			"states": [
			]
		},
		{
			"callingCode": "+1-869",
			"code": "KN",
			"displayName": "Saint Kitts and Nevis",
			"states": [
			]
		},
		{
			"callingCode": "+1-758",
			"code": "LC",
			"displayName": "Saint Lucia",
			"states": [
			]
		},
		{
			"callingCode": "+508",
			"code": "PM",
			"displayName": "Saint Pierre and Miquelon",
			"states": [
			]
		},
		{
			"callingCode": "+1-784",
			"code": "VC",
			"displayName": "Saint Vincent and the Grenadines",
			"states": [
			]
		},
		{
			"callingCode": "+685",
			"code": "WS",
			"displayName": "Samoa",
			"states": [
			]
		},
		{
			"callingCode": "+378",
			"code": "SM",
			"displayName": "San Marino",
			"states": [
			]
		},
		{
			"callingCode": "+239",
			"code": "ST",
			"displayName": "Sao Tome and Principe",
			"states": [
			]
		},
		{
			"callingCode": "+966",
			"code": "SA",
			"displayName": "Saudi Arabia",
			"states": [
			]
		},
		{
			"callingCode": "+221",
			"code": "SN",
			"displayName": "Senegal",
			"states": [
			]
		},
		{
			"callingCode": "+248",
			"code": "SC",
			"displayName": "Seychelles",
			"states": [
			]
		},
		{
			"callingCode": "+232",
			"code": "SL",
			"displayName": "Sierra Leone",
			"states": [
			]
		},
		{
			"callingCode": "+65",
			"code": "SG",
			"displayName": "Singapore",
			"states": [
			]
		},
		{
			"callingCode": "+421",
			"code": "SK",
			"displayName": "Slovakia",
			"states": [
			]
		},
		{
			"callingCode": "+386",
			"code": "SI",
			"displayName": "Slovenia",
			"states": [
			]
		},
		{
			"callingCode": "+677",
			"code": "SB",
			"displayName": "Solomon Islands",
			"states": [
			]
		},
		{
			"callingCode": "+252",
			"code": "SO",
			"displayName": "Somalia",
			"states": [
			]
		},
		{
			"callingCode": "+27",
			"code": "ZA",
			"displayName": "South Africa",
			"states": [
			]
		},
		{
			"callingCode": "",
			"code": "GS",
			"displayName": "South Georgia and the South Sandwich Islands",
			"states": [
			]
		},
		{
			"callingCode": "+34",
			"code": "ES",
			"displayName": "Spain",
			"states": [
			]
		},
		{
			"callingCode": "+94",
			"code": "LK",
			"displayName": "Sri Lanka",
			"states": [
			]
		},
		{
			"callingCode": "+249",
			"code": "SD",
			"displayName": "Sudan",
			"states": [
			]
		},
		{
			"callingCode": "+597",
			"code": "SR",
			"displayName": "Suriname",
			"states": [
			]
		},
		{
			"callingCode": "+79",
			"code": "SJ",
			"displayName": "Svalbard and Jan Mayen",
			"states": [
			]
		},
		{
			"callingCode": "+268",
			"code": "SZ",
			"displayName": "Swaziland",
			"states": [
			]
		},
		{
			"callingCode": "+46",
			"code": "SE",
			"displayName": "Sweden",
			"states": [
			]
		},
		{
			"callingCode": "+41",
			"code": "CH",
			"displayName": "Switzerland",
			"states": [
			]
		},
		{
			"callingCode": "+963",
			"code": "SY",
			"displayName": "Syria",
			"states": [
			]
		},
		{
			"callingCode": "+886",
			"code": "TW",
			"displayName": "Taiwan",
			"states": [
			]
		},
		{
			"callingCode": "+992",
			"code": "TJ",
			"displayName": "Tajikistan",
			"states": [
			]
		},
		{
			"callingCode": "+255",
			"code": "TZ",
			"displayName": "Tanzania",
			"states": [
			]
		},
		{
			"callingCode": "+66",
			"code": "TH",
			"displayName": "Thailand",
			"states": [
			]
		},
		{
			"callingCode": "+228",
			"code": "TG",
			"displayName": "Togo",
			"states": [
			]
		},
		{
			"callingCode": "+690",
			"code": "TK",
			"displayName": "Tokelau",
			"states": [
			]
		},
		{
			"callingCode": "+676",
			"code": "TO",
			"displayName": "Tonga",
			"states": [
			]
		},
		{
			"callingCode": "+1-868",
			"code": "TT",
			"displayName": "Trinidad and Tobago",
			"states": [
			]
		},
		{
			"callingCode": "+216",
			"code": "TN",
			"displayName": "Tunisia",
			"states": [
			]
		},
		{
			"callingCode": "+90",
			"code": "TR",
			"displayName": "Turkey",
			"states": [
			]
		},
		{
			"callingCode": "+993",
			"code": "TM",
			"displayName": "Turkmenistan",
			"states": [
			]
		},
		{
			"callingCode": "+1-649",
			"code": "TC",
			"displayName": "Turks and Caicos Islands",
			"states": [
			]
		},
		{
			"callingCode": "+688",
			"code": "TV",
			"displayName": "Tuvalu",
			"states": [
			]
		},
		{
			"callingCode": "+256",
			"code": "UG",
			"displayName": "Uganda",
			"states": [
			]
		},
		{
			"callingCode": "+380",
			"code": "UA",
			"displayName": "Ukraine",
			"states": [
			]
		},
		{
			"callingCode": "+971",
			"code": "AE",
			"displayName": "United Arab Emirates",
			"states": [
			]
		},
		{
			"callingCode": "+44",
			"code": "GB",
			"displayName": "United Kingdom",
			"states": [
			]
		},
		{
			"callingCode": "+1",
			"code": "US",
			"displayName": "United States",
			"states": [
				{
					"code": "AL",
					"displayName": "Alabama"
				},
				{
					"code": "AK",
					"displayName": "Alaska"
				},
				{
					"code": "AS",
					"displayName": "American Samoa"
				},
				{
					"code": "AZ",
					"displayName": "Arizona"
				},
				{
					"code": "AR",
					"displayName": "Arkansas"
				},
				{
					"code": "AA",
					"displayName": "Armed Forces Americas"
				},
				{
					"code": "AE",
					"displayName": "Armed Forces Europe"
				},
				{
					"code": "AP",
					"displayName": "Armed Forces Pacific"
				},
				{
					"code": "CA",
					"displayName": "California"
				},
				{
					"code": "CO",
					"displayName": "Colorado"
				},
				{
					"code": "CT",
					"displayName": "Connecticut"
				},
				{
					"code": "DE",
					"displayName": "Delaware"
				},
				{
					"code": "DC",
					"displayName": "District of Columbia"
				},
				{
					"code": "FL",
					"displayName": "Florida"
				},
				{
					"code": "GA",
					"displayName": "Georgia"
				},
				{
					"code": "GU",
					"displayName": "Guam"
				},
				{
					"code": "HI",
					"displayName": "Hawaii"
				},
				{
					"code": "ID",
					"displayName": "Idaho"
				},
				{
					"code": "IL",
					"displayName": "Illinois"
				},
				{
					"code": "IN",
					"displayName": "Indiana"
				},
				{
					"code": "IA",
					"displayName": "Iowa"
				},
				{
					"code": "KS",
					"displayName": "Kansas"
				},
				{
					"code": "KY",
					"displayName": "Kentucky"
				},
				{
					"code": "LA",
					"displayName": "Louisiana"
				},
				{
					"code": "ME",
					"displayName": "Maine"
				},
				{
					"code": "MD",
					"displayName": "Maryland"
				},
				{
					"code": "MA",
					"displayName": "Massachusetts"
				},
				{
					"code": "MI",
					"displayName": "Michigan"
				},
				{
					"code": "MN",
					"displayName": "Minnesota"
				},
				{
					"code": "MS",
					"displayName": "Mississippi"
				},
				{
					"code": "MO",
					"displayName": "Missouri"
				},
				{
					"code": "MT",
					"displayName": "Montana"
				},
				{
					"code": "NE",
					"displayName": "Nebraska"
				},
				{
					"code": "NV",
					"displayName": "Nevada"
				},
				{
					"code": "NH",
					"displayName": "New Hampshire"
				},
				{
					"code": "NJ",
					"displayName": "New Jersey"
				},
				{
					"code": "NM",
					"displayName": "New Mexico"
				},
				{
					"code": "NY",
					"displayName": "New York"
				},
				{
					"code": "NC",
					"displayName": "North Carolina"
				},
				{
					"code": "ND",
					"displayName": "North Dakota"
				},
				{
					"code": "MP",
					"displayName": "Northern Mariana Islands"
				},
				{
					"code": "OH",
					"displayName": "Ohio"
				},
				{
					"code": "OK",
					"displayName": "Oklahoma"
				},
				{
					"code": "OR",
					"displayName": "Oregon"
				},
				{
					"code": "PW",
					"displayName": "Palau"
				},
				{
					"code": "PA",
					"displayName": "Pennsylvania"
				},
				{
					"code": "RI",
					"displayName": "Rhode Island"
				},
				{
					"code": "SC",
					"displayName": "South Carolina"
				},
				{
					"code": "SD",
					"displayName": "South Dakota"
				},
				{
					"code": "TN",
					"displayName": "Tennessee"
				},
				{
					"code": "TX",
					"displayName": "Texas"
				},
				{
					"code": "VI",
					"displayName": "U.S. Virgin Islands"
				},
				{
					"code": "UT",
					"displayName": "Utah"
				},
				{
					"code": "VT",
					"displayName": "Vermont"
				},
				{
					"code": "VA",
					"displayName": "Virginia"
				},
				{
					"code": "WA",
					"displayName": "Washington"
				},
				{
					"code": "WV",
					"displayName": "West Virginia"
				},
				{
					"code": "WI",
					"displayName": "Wisconsin"
				},
				{
					"code": "WY",
					"displayName": "Wyoming"
				}
			]
		},
		{
			"callingCode": "+808",
			"code": "UM",
			"displayName": "United States Minor Outlying Islands",
			"states": [
			]
		},
		{
			"callingCode": "+598",
			"code": "UY",
			"displayName": "Uruguay",
			"states": [
			]
		},
		{
			"callingCode": "+998",
			"code": "UZ",
			"displayName": "Uzbekistan",
			"states": [
			]
		},
		{
			"callingCode": "+678",
			"code": "VU",
			"displayName": "Vanuatu",
			"states": [
			]
		},
		{
			"callingCode": "+58",
			"code": "VE",
			"displayName": "Venezuela",
			"states": [
			]
		},
		{
			"callingCode": "+84",
			"code": "VN",
			"displayName": "Viet Nam",
			"states": [
			]
		},
		{
			"callingCode": "+1-284",
			"code": "VG",
			"displayName": "Virgin Islands, British",
			"states": [
			]
		},
		{
			"callingCode": "+1-340",
			"code": "VI",
			"displayName": "Virgin Islands, US",
			"states": [
			]
		},
		{
			"callingCode": "+681",
			"code": "WF",
			"displayName": "Wallis and Futuna",
			"states": [
			]
		},
		{
			"callingCode": "+212",
			"code": "EH",
			"displayName": "Western Saraha",
			"states": [
			]
		},
		{
			"callingCode": "+967",
			"code": "YE",
			"displayName": "Yemen",
			"states": [
			]
		},
		{
			"callingCode": "+381",
			"code": "YU",
			"displayName": "Yugoslavia",
			"states": [
			]
		},
		{
			"callingCode": "+260",
			"code": "ZM",
			"displayName": "Zambia",
			"states": [
			]
		},
		{
			"callingCode": "+263",
			"code": "ZW",
			"displayName": "Zimbabwe",
			"states": [
			]
		}
	],
	"countryCodeStates": null
}

GET /store/{storeId}/country/country_state_name

Retrieve the display name of a country and/or a state.

Handler Method:

findCountryStateName

Secure Call Mandatory:

false

Partial Authentication Allowed:

false

Parameters:
NameDescriptionParameter TypeData TypeRequiredAllow Multiple
storeIdThe store identifier.pathstringtrueN/A
profileNameProfile name. Profiles determine the subset of data to be returned by a query. Default profile name = IBM_countryStateNamequerystringfalsefalse
countryCodeThe country or region abbreviation codequerystringfalsefalse
stateCodeThe state or province abbreviation code.querystringfalsefalse
HTTP Status Codes:
HTTP Status CodeDescription
200The requested completed successfully.
400Bad request. Some of the inputs provided to the request aren't valid.
401Not authenticated. The user session isn't valid.
403The user isn't authorized to perform the specified request.
500Internal server error. Additional details will be contained on the server logs.
Response Data Type:

com.ibm.commerce.user.beans.CountryStateListDataBean_IBM_countryStateName


Example

Request:
GET /wcs/resources/store/10001/country/country_state_name?countryCode=CA&langId=-1&stateCode=ON&responseFormat=json
HTTP Status Code:

200

Response:
{
	"countryDisplayName": "Canada",
	"stateDisplayName": "Ontario"
}

Data Type Details

com.ibm.commerce.user.beans.CountryStateListDataBean_IBM_countryStateList_Summary

com.ibm.commerce.user.beans.CountryStateListDataBean_IBM_countryStateList_Summary.countries

com.ibm.commerce.user.beans.CountryStateListDataBean_IBM_countryStateList_Summary.countryCodeStates

Properties:
NameData TypeRequired
displayNamestringfalse
codestringfalse

com.ibm.commerce.user.beans.CountryStateListDataBean_IBM_countryStateName

Properties:
NameData TypeRequired
countryDisplayNamestringfalse
stateDisplayNamestringfalse