Get Dial Code by Country

Retrieve the international dial code for a single country by ISO2, ISO3, or numeric ID

GET /v1/phone/{ciso}

cURL (ISO2)

curl -X GET 'https://api.countrystatecity.in/v1/phone/US' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl -X GET 'https://api.countrystatecity.in/v1/phone/IND' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl -X GET 'https://api.countrystatecity.in/v1/phone/233' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

const response = await fetch('https://api.countrystatecity.in/v1/phone/US', {
  headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});

const { dial_code } = await response.json();
console.log(dial_code); // "+1"

import requests

response = requests.get(
  'https://api.countrystatecity.in/v1/phone/IN',
  headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)

print(response.json()['dial_code'])  # "+91"

200 - Standard country

{
  "country": "IN",
  "dial_code": "+91",
  "iso2": "IN",
  "iso3": "IND"
}

{
  "country": "BB",
  "dial_code": "+1",
  "area_code": "246",
  "iso2": "BB",
  "iso3": "BRB"
}

{
  "error": "This feature is not available on your current plan.",
  "feature": "phoneDialCode",
  "upgradeUrl": "https://app.countrystatecity.in/pricing"
}

{
  "error": "Country not found."
}

{
  "error": "No dial code available for this country."
}

Get the dial code for one country. The path parameter accepts three forms — the same identifier flexibility as the rest of the geographic API:

• ISO 3166-1 alpha-2 (e.g. US, IN)
• ISO 3166-1 alpha-3 (e.g. USA, IND)
• Numeric CSC country ID (e.g. 233)

Availability: Supporter plan and above. Returns 403 on lower tiers.

Responses are cached server-side for 24 hours. Numeric IDs 1 and 001 resolve to the same cache slot; letter codes are case-insensitive.

Authentication

X-CSCAPI-KEY · string · required

Your API key for authentication

Path Parameters

ciso · string · required

ISO2 code, ISO3 code, or numeric country ID. Case-insensitive for ISO codes.

Response

A single phone entry (object, not an array — unlike the list endpoint).

country · string

ISO 3166-1 alpha-2 code of the country (e.g. "US"). Convenience field equal to iso2.

dial_code · string

Dial code with leading + (e.g. "+91").

area_code · string

Present only for NANP entries with a fixed area-code prefix in the underlying data (e.g. "246" for Barbados). Omitted when not applicable — do not assume the field exists.

iso2 · string

ISO 3166-1 alpha-2 code.

iso3 · string

ISO 3166-1 alpha-3 code.

cURL (ISO2)

curl -X GET 'https://api.countrystatecity.in/v1/phone/US' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl -X GET 'https://api.countrystatecity.in/v1/phone/IND' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl -X GET 'https://api.countrystatecity.in/v1/phone/233' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

const response = await fetch('https://api.countrystatecity.in/v1/phone/US', {
  headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});

const { dial_code } = await response.json();
console.log(dial_code); // "+1"

import requests

response = requests.get(
  'https://api.countrystatecity.in/v1/phone/IN',
  headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)

print(response.json()['dial_code'])  # "+91"

200 - Standard country

{
  "country": "IN",
  "dial_code": "+91",
  "iso2": "IN",
  "iso3": "IND"
}

{
  "country": "BB",
  "dial_code": "+1",
  "area_code": "246",
  "iso2": "BB",
  "iso3": "BRB"
}

{
  "error": "This feature is not available on your current plan.",
  "feature": "phoneDialCode",
  "upgradeUrl": "https://app.countrystatecity.in/pricing"
}

{
  "error": "Country not found."
}

{
  "error": "No dial code available for this country."
}

Related Endpoints

• List Dial Codes — every country, plus reverse lookup by dial code
• Parse Phone Number — given an E.164 number, identify the country
• Get Country Details — full country record, including phonecode