Get Country by ISO Code

This request returns the country associated with an ISO 3166-1 alpha-3 code.

get	/countries/{country_code}

Sample

A sample GET request to get a country, targeted by ISO code (with the common name excluded):

curl -X GET \
'https://api.carrierx.com/core/v2/countries/ITA?exclude_fields=common_name' \
-H 'Authorization: Bearer 5ebc03d6-8b2b-44ad-bf65-72d4f1491dda'

Response

200 status code with a serialized copy of the Country object:

{
    "capital": "Rome",
    "dialing_prefix": "39",
    "domain": "it",
    "iso_3166_alpha_2": "IT",
    "iso_3166_alpha_3": "ITA",
    "iso_3166_numeric": 380,
    "mcc": "222",
    "official_name": "Italian Republic",
    "region": "Europe",
    "subregion": "Southern Europe"
}

This request is enabled for Field Filtering.

Required Scopes

To get information about a Country object, the partner must have one of the following scopes enabled:

• countries.manage
• countries.read

Path Arguments

Parameter	Data Type	Description
country_code required	string	The ISO 3166-1 alpha-3 code of the country.