Skip to main content
GET
/
v1
/
public
/
atlas
List Countries
curl --request GET \
  --url https://{defaultHost}/v1/public/atlas \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "code": "AF",
      "name": "Afghanistan",
      "states_count": 0
    },
    {
      "code": "AX",
      "name": "Åland Islands",
      "states_count": 0
    },
    {
      "code": "AL",
      "name": "Albania",
      "states_count": 0
    },
    {
      "code": "DZ",
      "name": "Algeria",
      "states_count": 0
    },
    {
      "code": "AD",
      "name": "Andorra",
      "states_count": 0
    },
    {
      "code": "AO",
      "name": "Angola",
      "states_count": 0
    },
    {
      "code": "AI",
      "name": "Anguilla",
      "states_count": 0
    },
    {
      "code": "AG",
      "name": "Antigua & Barbuda",
      "states_count": 0
    },
    {
      "code": "AR",
      "name": "Argentina",
      "states_count": 24
    },
    {
      "code": "AM",
      "name": "Armenia",
      "states_count": 0
    },
    {
      "code": "AW",
      "name": "Aruba",
      "states_count": 0
    },
    {
      "code": "AC",
      "name": "Ascension Island",
      "states_count": 0
    },
    {
      "code": "AU",
      "name": "Australia",
      "states_count": 8
    },
    {
      "code": "AT",
      "name": "Austria",
      "states_count": 0
    },
    {
      "code": "AZ",
      "name": "Azerbaijan",
      "states_count": 0
    },
    {
      "code": "BS",
      "name": "Bahamas",
      "states_count": 0
    },
    {
      "code": "BH",
      "name": "Bahrain",
      "states_count": 0
    },
    {
      "code": "BD",
      "name": "Bangladesh",
      "states_count": 0
    },
    {
      "code": "BB",
      "name": "Barbados",
      "states_count": 0
    },
    {
      "code": "BY",
      "name": "Belarus",
      "states_count": 0
    },
    {
      "code": "BE",
      "name": "Belgium",
      "states_count": 0
    },
    {
      "code": "BZ",
      "name": "Belize",
      "states_count": 0
    },
    {
      "code": "BJ",
      "name": "Benin",
      "states_count": 0
    },
    {
      "code": "BM",
      "name": "Bermuda",
      "states_count": 0
    },
    {
      "code": "BT",
      "name": "Bhutan",
      "states_count": 0
    },
    {
      "code": "BO",
      "name": "Bolivia",
      "states_count": 0
    },
    {
      "code": "BA",
      "name": "Bosnia & Herzegovina",
      "states_count": 0
    },
    {
      "code": "BW",
      "name": "Botswana",
      "states_count": 0
    },
    {
      "code": "BV",
      "name": "Bouvet Island",
      "states_count": 0
    },
    {
      "code": "BR",
      "name": "Brazil",
      "states_count": 27
    },
    {
      "code": "IO",
      "name": "British Indian Ocean Territory",
      "states_count": 0
    },
    {
      "code": "BN",
      "name": "Brunei",
      "states_count": 0
    },
    {
      "code": "BG",
      "name": "Bulgaria",
      "states_count": 0
    },
    {
      "code": "BF",
      "name": "Burkina Faso",
      "states_count": 0
    },
    {
      "code": "BI",
      "name": "Burundi",
      "states_count": 0
    },
    {
      "code": "KH",
      "name": "Cambodia",
      "states_count": 0
    },
    {
      "code": "CA",
      "name": "Canada",
      "states_count": 13
    },
    {
      "code": "CV",
      "name": "Cape Verde",
      "states_count": 0
    },
    {
      "code": "BQ",
      "name": "Caribbean Netherlands",
      "states_count": 0
    },
    {
      "code": "KY",
      "name": "Cayman Islands",
      "states_count": 0
    },
    {
      "code": "CF",
      "name": "Central African Republic",
      "states_count": 0
    },
    {
      "code": "TD",
      "name": "Chad",
      "states_count": 0
    },
    {
      "code": "CL",
      "name": "Chile",
      "states_count": 16
    },
    {
      "code": "CN",
      "name": "China",
      "states_count": 31
    },
    {
      "code": "CX",
      "name": "Christmas Island",
      "states_count": 0
    },
    {
      "code": "CC",
      "name": "Cocos (Keeling) Islands",
      "states_count": 0
    },
    {
      "code": "CO",
      "name": "Colombia",
      "states_count": 33
    },
    {
      "code": "KM",
      "name": "Comoros",
      "states_count": 0
    },
    {
      "code": "CG",
      "name": "Congo - Brazzaville",
      "states_count": 0
    },
    {
      "code": "CD",
      "name": "Congo - Kinshasa",
      "states_count": 0
    },
    {
      "code": "CK",
      "name": "Cook Islands",
      "states_count": 0
    },
    {
      "code": "CR",
      "name": "Costa Rica",
      "states_count": 7
    },
    {
      "code": "HR",
      "name": "Croatia",
      "states_count": 0
    },
    {
      "code": "CU",
      "name": "Cuba",
      "states_count": 0
    },
    {
      "code": "CW",
      "name": "Curaçao",
      "states_count": 0
    },
    {
      "code": "CY",
      "name": "Cyprus",
      "states_count": 0
    },
    {
      "code": "CZ",
      "name": "Czechia",
      "states_count": 0
    },
    {
      "code": "CI",
      "name": "Côte d’Ivoire",
      "states_count": 0
    },
    {
      "code": "DK",
      "name": "Denmark",
      "states_count": 0
    },
    {
      "code": "DJ",
      "name": "Djibouti",
      "states_count": 0
    },
    {
      "code": "DM",
      "name": "Dominica",
      "states_count": 0
    },
    {
      "code": "DO",
      "name": "Dominican Republic",
      "states_count": 0
    },
    {
      "code": "EC",
      "name": "Ecuador",
      "states_count": 0
    },
    {
      "code": "EG",
      "name": "Egypt",
      "states_count": 29
    },
    {
      "code": "SV",
      "name": "El Salvador",
      "states_count": 14
    },
    {
      "code": "GQ",
      "name": "Equatorial Guinea",
      "states_count": 0
    },
    {
      "code": "ER",
      "name": "Eritrea",
      "states_count": 0
    },
    {
      "code": "EE",
      "name": "Estonia",
      "states_count": 0
    },
    {
      "code": "SZ",
      "name": "Eswatini",
      "states_count": 0
    },
    {
      "code": "ET",
      "name": "Ethiopia",
      "states_count": 0
    },
    {
      "code": "FK",
      "name": "Falkland Islands",
      "states_count": 0
    },
    {
      "code": "FO",
      "name": "Faroe Islands",
      "states_count": 0
    },
    {
      "code": "FJ",
      "name": "Fiji",
      "states_count": 0
    },
    {
      "code": "FI",
      "name": "Finland",
      "states_count": 0
    },
    {
      "code": "FR",
      "name": "France",
      "states_count": 0
    },
    {
      "code": "GF",
      "name": "French Guiana",
      "states_count": 0
    },
    {
      "code": "PF",
      "name": "French Polynesia",
      "states_count": 0
    },
    {
      "code": "TF",
      "name": "French Southern Territories",
      "states_count": 0
    },
    {
      "code": "GA",
      "name": "Gabon",
      "states_count": 0
    },
    {
      "code": "GM",
      "name": "Gambia",
      "states_count": 0
    },
    {
      "code": "GE",
      "name": "Georgia",
      "states_count": 0
    },
    {
      "code": "DE",
      "name": "Germany",
      "states_count": 0
    },
    {
      "code": "GH",
      "name": "Ghana",
      "states_count": 0
    },
    {
      "code": "GI",
      "name": "Gibraltar",
      "states_count": 0
    },
    {
      "code": "GR",
      "name": "Greece",
      "states_count": 0
    },
    {
      "code": "GL",
      "name": "Greenland",
      "states_count": 0
    },
    {
      "code": "GD",
      "name": "Grenada",
      "states_count": 0
    },
    {
      "code": "GP",
      "name": "Guadeloupe",
      "states_count": 0
    },
    {
      "code": "GT",
      "name": "Guatemala",
      "states_count": 22
    },
    {
      "code": "GG",
      "name": "Guernsey",
      "states_count": 0
    },
    {
      "code": "GN",
      "name": "Guinea",
      "states_count": 0
    },
    {
      "code": "GW",
      "name": "Guinea-Bissau",
      "states_count": 0
    },
    {
      "code": "GY",
      "name": "Guyana",
      "states_count": 0
    },
    {
      "code": "HT",
      "name": "Haiti",
      "states_count": 0
    },
    {
      "code": "HM",
      "name": "Heard & McDonald Islands",
      "states_count": 0
    },
    {
      "code": "VA",
      "name": "Vatican City",
      "states_count": 0
    },
    {
      "code": "HN",
      "name": "Honduras",
      "states_count": 0
    },
    {
      "code": "HK",
      "name": "Hong Kong SAR",
      "states_count": 3
    },
    {
      "code": "HU",
      "name": "Hungary",
      "states_count": 0
    },
    {
      "code": "IS",
      "name": "Iceland",
      "states_count": 0
    },
    {
      "code": "IN",
      "name": "India",
      "states_count": 37
    },
    {
      "code": "ID",
      "name": "Indonesia",
      "states_count": 34
    },
    {
      "code": "IR",
      "name": "Iran",
      "states_count": 0
    },
    {
      "code": "IQ",
      "name": "Iraq",
      "states_count": 0
    },
    {
      "code": "IE",
      "name": "Ireland",
      "states_count": 26
    },
    {
      "code": "IM",
      "name": "Isle of Man",
      "states_count": 0
    },
    {
      "code": "IL",
      "name": "Israel",
      "states_count": 0
    },
    {
      "code": "IT",
      "name": "Italy",
      "states_count": 110
    },
    {
      "code": "JM",
      "name": "Jamaica",
      "states_count": 0
    },
    {
      "code": "JP",
      "name": "Japan",
      "states_count": 47
    },
    {
      "code": "JE",
      "name": "Jersey",
      "states_count": 0
    },
    {
      "code": "JO",
      "name": "Jordan",
      "states_count": 0
    },
    {
      "code": "KZ",
      "name": "Kazakhstan",
      "states_count": 0
    },
    {
      "code": "KE",
      "name": "Kenya",
      "states_count": 0
    },
    {
      "code": "KI",
      "name": "Kiribati",
      "states_count": 0
    },
    {
      "code": "KP",
      "name": "North Korea",
      "states_count": 0
    },
    {
      "code": "XK",
      "name": "Kosovo",
      "states_count": 0
    },
    {
      "code": "KW",
      "name": "Kuwait",
      "states_count": 6
    },
    {
      "code": "KG",
      "name": "Kyrgyzstan",
      "states_count": 0
    },
    {
      "code": "LA",
      "name": "Laos",
      "states_count": 0
    },
    {
      "code": "LV",
      "name": "Latvia",
      "states_count": 0
    },
    {
      "code": "LB",
      "name": "Lebanon",
      "states_count": 0
    },
    {
      "code": "LS",
      "name": "Lesotho",
      "states_count": 0
    },
    {
      "code": "LR",
      "name": "Liberia",
      "states_count": 0
    },
    {
      "code": "LY",
      "name": "Libya",
      "states_count": 0
    },
    {
      "code": "LI",
      "name": "Liechtenstein",
      "states_count": 0
    },
    {
      "code": "LT",
      "name": "Lithuania",
      "states_count": 0
    },
    {
      "code": "LU",
      "name": "Luxembourg",
      "states_count": 0
    },
    {
      "code": "MO",
      "name": "Macao SAR",
      "states_count": 0
    },
    {
      "code": "MG",
      "name": "Madagascar",
      "states_count": 0
    },
    {
      "code": "MW",
      "name": "Malawi",
      "states_count": 0
    },
    {
      "code": "MY",
      "name": "Malaysia",
      "states_count": 16
    },
    {
      "code": "MV",
      "name": "Maldives",
      "states_count": 0
    },
    {
      "code": "ML",
      "name": "Mali",
      "states_count": 0
    },
    {
      "code": "MT",
      "name": "Malta",
      "states_count": 0
    },
    {
      "code": "MQ",
      "name": "Martinique",
      "states_count": 0
    },
    {
      "code": "MR",
      "name": "Mauritania",
      "states_count": 0
    },
    {
      "code": "MU",
      "name": "Mauritius",
      "states_count": 0
    },
    {
      "code": "YT",
      "name": "Mayotte",
      "states_count": 0
    },
    {
      "code": "MX",
      "name": "Mexico",
      "states_count": 32
    },
    {
      "code": "MD",
      "name": "Moldova",
      "states_count": 0
    },
    {
      "code": "MC",
      "name": "Monaco",
      "states_count": 0
    },
    {
      "code": "MN",
      "name": "Mongolia",
      "states_count": 0
    },
    {
      "code": "ME",
      "name": "Montenegro",
      "states_count": 0
    },
    {
      "code": "MS",
      "name": "Montserrat",
      "states_count": 0
    },
    {
      "code": "MA",
      "name": "Morocco",
      "states_count": 0
    },
    {
      "code": "MZ",
      "name": "Mozambique",
      "states_count": 0
    },
    {
      "code": "MM",
      "name": "Myanmar (Burma)",
      "states_count": 0
    },
    {
      "code": "NA",
      "name": "Namibia",
      "states_count": 0
    },
    {
      "code": "NR",
      "name": "Nauru",
      "states_count": 0
    },
    {
      "code": "NP",
      "name": "Nepal",
      "states_count": 0
    },
    {
      "code": "NL",
      "name": "Netherlands",
      "states_count": 0
    },
    {
      "code": "AN",
      "name": "Netherlands Antilles",
      "states_count": 0
    },
    {
      "code": "NC",
      "name": "New Caledonia",
      "states_count": 0
    },
    {
      "code": "NZ",
      "name": "New Zealand",
      "states_count": 0
    },
    {
      "code": "NI",
      "name": "Nicaragua",
      "states_count": 0
    },
    {
      "code": "NE",
      "name": "Niger",
      "states_count": 0
    },
    {
      "code": "NG",
      "name": "Nigeria",
      "states_count": 37
    },
    {
      "code": "NU",
      "name": "Niue",
      "states_count": 0
    },
    {
      "code": "NF",
      "name": "Norfolk Island",
      "states_count": 0
    },
    {
      "code": "MK",
      "name": "North Macedonia",
      "states_count": 0
    },
    {
      "code": "NO",
      "name": "Norway",
      "states_count": 0
    },
    {
      "code": "OM",
      "name": "Oman",
      "states_count": 0
    },
    {
      "code": "PK",
      "name": "Pakistan",
      "states_count": 0
    },
    {
      "code": "PS",
      "name": "Palestinian Territories",
      "states_count": 0
    },
    {
      "code": "PA",
      "name": "Panama",
      "states_count": 13
    },
    {
      "code": "PG",
      "name": "Papua New Guinea",
      "states_count": 0
    },
    {
      "code": "PY",
      "name": "Paraguay",
      "states_count": 0
    },
    {
      "code": "PE",
      "name": "Peru",
      "states_count": 26
    },
    {
      "code": "PH",
      "name": "Philippines",
      "states_count": 82
    },
    {
      "code": "PN",
      "name": "Pitcairn Islands",
      "states_count": 0
    },
    {
      "code": "PL",
      "name": "Poland",
      "states_count": 0
    },
    {
      "code": "PT",
      "name": "Portugal",
      "states_count": 20
    },
    {
      "code": "QA",
      "name": "Qatar",
      "states_count": 0
    },
    {
      "code": "CM",
      "name": "Cameroon",
      "states_count": 0
    },
    {
      "code": "RE",
      "name": "Réunion",
      "states_count": 0
    },
    {
      "code": "RO",
      "name": "Romania",
      "states_count": 42
    },
    {
      "code": "RU",
      "name": "Russia",
      "states_count": 83
    },
    {
      "code": "RW",
      "name": "Rwanda",
      "states_count": 0
    },
    {
      "code": "BL",
      "name": "St. Barthélemy",
      "states_count": 0
    },
    {
      "code": "SH",
      "name": "St. Helena",
      "states_count": 0
    },
    {
      "code": "KN",
      "name": "St. Kitts & Nevis",
      "states_count": 0
    },
    {
      "code": "LC",
      "name": "St. Lucia",
      "states_count": 0
    },
    {
      "code": "MF",
      "name": "St. Martin",
      "states_count": 0
    },
    {
      "code": "PM",
      "name": "St. Pierre & Miquelon",
      "states_count": 0
    },
    {
      "code": "WS",
      "name": "Samoa",
      "states_count": 0
    },
    {
      "code": "SM",
      "name": "San Marino",
      "states_count": 0
    },
    {
      "code": "ST",
      "name": "São Tomé & Príncipe",
      "states_count": 0
    },
    {
      "code": "SA",
      "name": "Saudi Arabia",
      "states_count": 0
    },
    {
      "code": "SN",
      "name": "Senegal",
      "states_count": 0
    },
    {
      "code": "RS",
      "name": "Serbia",
      "states_count": 0
    },
    {
      "code": "SC",
      "name": "Seychelles",
      "states_count": 0
    },
    {
      "code": "SL",
      "name": "Sierra Leone",
      "states_count": 0
    },
    {
      "code": "SG",
      "name": "Singapore",
      "states_count": 0
    },
    {
      "code": "SX",
      "name": "Sint Maarten",
      "states_count": 0
    },
    {
      "code": "SK",
      "name": "Slovakia",
      "states_count": 0
    },
    {
      "code": "SI",
      "name": "Slovenia",
      "states_count": 0
    },
    {
      "code": "SB",
      "name": "Solomon Islands",
      "states_count": 0
    },
    {
      "code": "SO",
      "name": "Somalia",
      "states_count": 0
    },
    {
      "code": "ZA",
      "name": "South Africa",
      "states_count": 9
    },
    {
      "code": "GS",
      "name": "South Georgia & South Sandwich Islands",
      "states_count": 0
    },
    {
      "code": "KR",
      "name": "South Korea",
      "states_count": 17
    },
    {
      "code": "SS",
      "name": "South Sudan",
      "states_count": 0
    },
    {
      "code": "ES",
      "name": "Spain",
      "states_count": 52
    },
    {
      "code": "LK",
      "name": "Sri Lanka",
      "states_count": 0
    },
    {
      "code": "VC",
      "name": "St. Vincent & Grenadines",
      "states_count": 0
    },
    {
      "code": "SD",
      "name": "Sudan",
      "states_count": 0
    },
    {
      "code": "SR",
      "name": "Suriname",
      "states_count": 0
    },
    {
      "code": "SJ",
      "name": "Svalbard & Jan Mayen",
      "states_count": 0
    },
    {
      "code": "SE",
      "name": "Sweden",
      "states_count": 0
    },
    {
      "code": "CH",
      "name": "Switzerland",
      "states_count": 0
    },
    {
      "code": "SY",
      "name": "Syria",
      "states_count": 0
    },
    {
      "code": "TW",
      "name": "Taiwan",
      "states_count": 0
    },
    {
      "code": "TJ",
      "name": "Tajikistan",
      "states_count": 0
    },
    {
      "code": "TZ",
      "name": "Tanzania",
      "states_count": 0
    },
    {
      "code": "TH",
      "name": "Thailand",
      "states_count": 78
    },
    {
      "code": "TL",
      "name": "Timor-Leste",
      "states_count": 0
    },
    {
      "code": "TG",
      "name": "Togo",
      "states_count": 0
    },
    {
      "code": "TK",
      "name": "Tokelau",
      "states_count": 0
    },
    {
      "code": "TO",
      "name": "Tonga",
      "states_count": 0
    },
    {
      "code": "TT",
      "name": "Trinidad & Tobago",
      "states_count": 0
    },
    {
      "code": "TA",
      "name": "Tristan da Cunha",
      "states_count": 0
    },
    {
      "code": "TN",
      "name": "Tunisia",
      "states_count": 0
    },
    {
      "code": "TR",
      "name": "Türkiye",
      "states_count": 0
    },
    {
      "code": "TM",
      "name": "Turkmenistan",
      "states_count": 0
    },
    {
      "code": "TC",
      "name": "Turks & Caicos Islands",
      "states_count": 0
    },
    {
      "code": "TV",
      "name": "Tuvalu",
      "states_count": 0
    },
    {
      "code": "UG",
      "name": "Uganda",
      "states_count": 0
    },
    {
      "code": "UA",
      "name": "Ukraine",
      "states_count": 0
    },
    {
      "code": "AE",
      "name": "United Arab Emirates",
      "states_count": 7
    },
    {
      "code": "GB",
      "name": "United Kingdom",
      "states_count": 0
    },
    {
      "code": "US",
      "name": "United States",
      "states_count": 62
    },
    {
      "code": "UM",
      "name": "U.S. Outlying Islands",
      "states_count": 0
    },
    {
      "code": "UY",
      "name": "Uruguay",
      "states_count": 19
    },
    {
      "code": "UZ",
      "name": "Uzbekistan",
      "states_count": 0
    },
    {
      "code": "VU",
      "name": "Vanuatu",
      "states_count": 0
    },
    {
      "code": "VE",
      "name": "Venezuela",
      "states_count": 25
    },
    {
      "code": "VN",
      "name": "Vietnam",
      "states_count": 0
    },
    {
      "code": "VG",
      "name": "British Virgin Islands",
      "states_count": 0
    },
    {
      "code": "WF",
      "name": "Wallis & Futuna",
      "states_count": 0
    },
    {
      "code": "EH",
      "name": "Western Sahara",
      "states_count": 0
    },
    {
      "code": "YE",
      "name": "Yemen",
      "states_count": 0
    },
    {
      "code": "ZM",
      "name": "Zambia",
      "states_count": 0
    },
    {
      "code": "ZW",
      "name": "Zimbabwe",
      "states_count": 0
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

locale
string

The locale to use when returning the country information. Must follow CLDR locale format (e.g., "en", "en-US"). Unsupported or invalid locales will fall back to "en".

Response

200 - application/json

Success

object
string

A string describing the object type returned.

pagination
object
data
array

An array of objects.