Skip to main content
GET
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: Starter 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.

Response

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

Authorizations

X-CSCAPI-KEY
string
header
required

API key for authentication. Get your free key at app.countrystatecity.in.

Path Parameters

ciso
string
required

ISO 3166-1 alpha-2 (e.g., IN), alpha-3 (e.g., IND), or numeric country ID (e.g., 101). Case-insensitive.

Example:

"IN"

Response

Dial code for the country

International dial code entry for a country. Follows ITU-T E.164 standards.

country
string
required

ISO 3166-1 alpha-2 country code

Example:

"IN"

dial_code
string
required

International dial code with + prefix

Example:

"+91"

iso2
string
required

ISO 3166-1 alpha-2 code

Example:

"IN"

iso3
string
required

ISO 3166-1 alpha-3 code

Example:

"IND"

area_code
string | null

Fixed area code for NANP territories (e.g., 246 for Barbados). Present only when applicable.

Example:

null