Three field types carry a country in the REST API. Phone and IP Address take a two-letter code such as US. Address takes the full country name such as United States.
The table at the end lists every name and code the API accepts.
Example: a vendor risk team syncs vendor contacts from a procurement system. The sync writes the vendor's phone country as GB and the head office country as United Kingdom.
Plan Availability | All plan types. Every request counts toward the monthly API allowance: 25,000 on Team, 100,000 on Professional, 500,000 on Enterprise, custom on Signature. |
Permissions | Any member with an API key. The key acts with that member's role and permissions. |
Platform | API |
Related Reading |
Which fields take a country?
Field. | Key. | Accepts. |
Phone. | phone_country. | Two-letter code. |
IP Address. | country_code. | Two-letter code. |
Address. | location_country. | Full country name. |
Example: a two-letter code
{
"phone_country": "US"
}Example: a full country name
{
"location_country": "United States"
}
Tip: Copy names exactly as the table shows them, including accents and the ampersand, such as "Côte d’Ivoire" or "Trinidad & Tobago".
Which names and codes are supported?
Country name. | Code. |
Afghanistan. | AF. |
Åland Islands. | AX. |
Albania. | AL. |
Algeria. | DZ. |
American Samoa. | AS. |
Andorra. | AD. |
Angola. | AO. |
Anguilla. | AI. |
Antarctica. | AQ. |
Antigua & Barbuda. | AG. |
Argentina. | AR. |
Armenia. | AM. |
Aruba. | AW. |
Ascension Island. | AC. |
Australia. | AU. |
Austria. | AT. |
Azerbaijan. | AZ. |
Bahamas. | BS. |
Bahrain. | BH. |
Bangladesh. | BD. |
Barbados. | BB. |
Belarus. | BY. |
Belgium. | BE. |
Belize. | BZ. |
Benin. | BJ. |
Bermuda. | BM. |
Bhutan. | BT. |
Bolivia. | BO. |
Bosnia & Herzegovina. | BA. |
Botswana. | BW. |
Brazil. | BR. |
British Indian Ocean Territory. | IO. |
British Virgin Islands. | VG. |
Brunei. | BN. |
Bulgaria. | BG. |
Burkina Faso. | BF. |
Burundi. | BI. |
Cambodia. | KH. |
Cameroon. | CM. |
Canada. | CA. |
Canary Islands. | IC. |
Cape Verde. | CV. |
Caribbean Netherlands. | BQ. |
Cayman Islands. | KY. |
Central African Republic. | CF. |
Ceuta & Melilla. | EA. |
Chad. | TD. |
Chile. | CL. |
China. | CN. |
Christmas Island. | CX. |
Cocos (Keeling) Islands. | CC. |
Colombia. | CO. |
Comoros. | KM. |
Congo - Brazzaville. | CG. |
Congo - Kinshasa. | CD. |
Cook Islands. | CK. |
Costa Rica. | CR. |
Côte d’Ivoire. | CI. |
Croatia. | HR. |
Cuba. | CU. |
Curaçao. | CW. |
Cyprus. | CY. |
Czechia. | CZ. |
Denmark. | DK. |
Diego Garcia. | DG. |
Djibouti. | DJ. |
Dominica. | DM. |
Dominican Republic. | DO. |
Ecuador. | EC. |
Egypt. | EG. |
El Salvador. | SV. |
Equatorial Guinea. | GQ. |
Eritrea. | ER. |
Estonia. | EE. |
Eswatini. | SZ. |
Ethiopia. | ET. |
Falkland Islands. | FK. |
Faroe Islands. | FO. |
Fiji. | FJ. |
Finland. | FI. |
France. | FR. |
French Guiana. | GF. |
French Polynesia. | PF. |
French Southern Territories. | TF. |
Gabon. | GA. |
Gambia. | GM. |
Georgia. | GE. |
Germany. | DE. |
Ghana. | GH. |
Gibraltar. | GI. |
Greece. | GR. |
Greenland. | GL. |
Grenada. | GD. |
Guadeloupe. | GP. |
Guam. | GU. |
Guatemala. | GT. |
Guernsey. | GG. |
Guinea. | GN. |
Guinea-Bissau. | GW. |
Guyana. | GY. |
Haiti. | HT. |
Honduras. | HN. |
Hong Kong SAR China. | HK. |
Hungary. | HU. |
Iceland. | IS. |
India. | IN. |
Indonesia. | ID. |
Iran. | IR. |
Iraq. | IQ. |
Ireland. | IE. |
Isle of Man. | IM. |
Israel. | IL. |
Italy. | IT. |
Jamaica. | JM. |
Japan. | JP. |
Jersey. | JE. |
Jordan. | JO. |
Kazakhstan. | KZ. |
Kenya. | KE. |
Kiribati. | KI. |
Kosovo. | XK. |
Kuwait. | KW. |
Kyrgyzstan. | KG. |
Laos. | LA. |
Latvia. | LV. |
Lebanon. | LB. |
Lesotho. | LS. |
Liberia. | LR. |
Libya. | LY. |
Liechtenstein. | LI. |
Lithuania. | LT. |
Luxembourg. | LU. |
Macao SAR China. | MO. |
Madagascar. | MG. |
Malawi. | MW. |
Malaysia. | MY. |
Maldives. | MV. |
Mali. | ML. |
Malta. | MT. |
Marshall Islands. | MH. |
Martinique. | MQ. |
Mauritania. | MR. |
Mauritius. | MU. |
Mayotte. | YT. |
Mexico. | MX. |
Micronesia. | FM. |
Moldova. | MD. |
Monaco. | MC. |
Mongolia. | MN. |
Montenegro. | ME. |
Montserrat. | MS. |
Morocco. | MA. |
Mozambique. | MZ. |
Myanmar (Burma). | MM. |
Namibia. | NA. |
Nauru. | NR. |
Nepal. | NP. |
Netherlands. | NL. |
New Caledonia. | NC. |
New Zealand. | NZ. |
Nicaragua. | NI. |
Niger. | NE. |
Nigeria. | NG. |
Niue. | NU. |
Norfolk Island. | NF. |
North Korea. | KP. |
North Macedonia. | MK. |
Northern Mariana Islands. | MP. |
Norway. | NO. |
Oman. | OM. |
Pakistan. | PK. |
Palau. | PW. |
Palestinian Territories. | PS. |
Panama. | PA. |
Papua New Guinea. | PG. |
Paraguay. | PY. |
Peru. | PE. |
Philippines. | PH. |
Pitcairn Islands. | PN. |
Poland. | PL. |
Portugal. | PT. |
Puerto Rico. | PR. |
Qatar. | QA. |
Réunion. | RE. |
Romania. | RO. |
Russia. | RU. |
Rwanda. | RW. |
Samoa. | WS. |
San Marino. | SM. |
São Tomé & Príncipe. | ST. |
Saudi Arabia. | SA. |
Senegal. | SN. |
Serbia. | RS. |
Seychelles. | SC. |
Sierra Leone. | SL. |
Singapore. | SG. |
Sint Maarten. | SX. |
Slovakia. | SK. |
Slovenia. | SI. |
Solomon Islands. | SB. |
Somalia. | SO. |
South Africa. | ZA. |
South Georgia & South Sandwich Islands. | GS. |
South Korea. | KR. |
South Sudan. | SS. |
Spain. | ES. |
Sri Lanka. | LK. |
St. Barthélemy. | BL. |
St. Helena. | SH. |
St. Kitts & Nevis. | KN. |
St. Lucia. | LC. |
St. Martin. | MF. |
St. Pierre & Miquelon. | PM. |
St. Vincent & Grenadines. | VC. |
Sudan. | SD. |
Suriname. | SR. |
Svalbard & Jan Mayen. | SJ. |
Sweden. | SE. |
Switzerland. | CH. |
Syria. | SY. |
Taiwan. | TW. |
Tajikistan. | TJ. |
Tanzania. | TZ. |
Thailand. | TH. |
Timor-Leste. | TL. |
Togo. | TG. |
Tokelau. | TK. |
Tonga. | TO. |
Trinidad & Tobago. | TT. |
Tunisia. | TN. |
Turkey. | TR. |
Turkmenistan. | TM. |
Turks & Caicos Islands. | TC. |
Tuvalu. | TV. |
U.S. Outlying Islands. | UM. |
U.S. Virgin Islands. | VI. |
Uganda. | UG. |
Ukraine. | UA. |
United Arab Emirates. | AE. |
United Kingdom. | GB. |
United States. | US. |
Uruguay. | UY. |
Uzbekistan. | UZ. |
Vanuatu. | VU. |
Vatican City. | VA. |
Venezuela. | VE. |
Vietnam. | VN. |
Wallis & Futuna. | WF. |
Western Sahara. | EH. |
Yemen. | YE. |
Zambia. | ZM. |
Zimbabwe. | ZW. |
The endpoints that write these fields are in the SmartSuite developer documentation.
Frequently asked questions
Which format does the Phone field use for the country?
Which format does the Phone field use for the country?
A two-letter code in phone_country, such as US for United States or GB for United Kingdom.
Which format does the Address field use?
Which format does the Address field use?
The full country name in location_country, such as United States. A two-letter code is not the format the table lists for Address.
What is the code for the United Kingdom?
What is the code for the United Kingdom?
GB. The full name for the Address field is United Kingdom.
Is the IP Address country set the same way as the Phone country?
Is the IP Address country set the same way as the Phone country?
Yes. Both take a two-letter code: country_code for IP Address and phone_country for Phone.
Need more help? Ask the SmartSuite Community, where builders, administrators and the SmartSuite team answer questions about building on SmartSuite. For your account, billing or data, select the chat button in the lower-right corner of SmartSuite to reach support.
Last verified 1 Nov 2026.