Skip to main content

Country Object

The Country object represents a single country and its associated standardized identifiers and metadata. It includes ISO 3166 codes, the country's common and official names, capital, regional classification, dialing information, and top-level Internet domain. This object is typically used to reference or validate country information within other API resources.

Country Object Attributes

These fields and values make up the JSON object that gets returned with successful requests.

AttributeData TypeDescription
capital
read only
string

The capital of the country.

common_name
read only
string

The common name of the country.

dialing_prefix
read only
string

The telephone code of the country.

domain
read only
string

The Internet domain of the country.

iso_3166_alpha_2
read only
string

The ISO 3166-1 alpha-2 code of the country.

iso_3166_alpha_3
read only
string

The ISO 3166-1 alpha-3 code of the country.

iso_3166_numeric
read only
integer

The ISO 3166-1 numeric code of the country.

mcc
read only
string

The mobile country code.

official_name
read only
string

The official name of the country.

region
read only
string

The region of the country.

subregion
read only
string

The subregion of the country.

Sample Country Object

{
"capital": "Washington D.C.",
"common_name": "United States",
"dialing_prefix": "1",
"domain": "us",
"iso_3166_alpha_2": "US",
"iso_3166_alpha_3": "USA",
"iso_3166_numeric": 840,
"mcc": "310,311,312,313,316",
"official_name": "United States of America",
"region": "Americas",
"subregion": "Northern America"
}