Get Timezone by Country

Retrieve the canonical timezone for a country including current DST state

GET /v1/timezone/{ciso}

cURL (ISO2)

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

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

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

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

const tz = await response.json();
// Format current time in that zone
const local = new Date().toLocaleString('en-US', { timeZone: tz.iana });
console.log(`${tz.iana} | ${local} | DST: ${tz.is_dst_now}`);

import requests
from datetime import datetime
from zoneinfo import ZoneInfo

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

tz = response.json()
now_local = datetime.now(ZoneInfo(tz['iana']))
print(f"{tz['iana']} ({tz['abbreviation']}) — {now_local}")

200 - DST-observing country (in summer)

{
  "iana": "America/New_York",
  "abbreviation": "EDT",
  "offset_utc": "-05:00",
  "dst_offset_utc": "-04:00",
  "is_dst_now": true
}

{
  "iana": "Asia/Kolkata",
  "abbreviation": "GMT+5:30",
  "offset_utc": "+05:30",
  "dst_offset_utc": "+05:30",
  "is_dst_now": false
}

{
  "error": "Unauthorized. You shouldn't be here."
}

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

{
  "error": "No timezone data available for this country."
}

Return the canonical IANA timezone for a country, plus its standard and DST UTC offsets and whether the country is observing DST at request time.

Resolution order:

1. The capital city’s timezone — most countries with multiple zones use this as the canonical default.
2. The first entry in the country’s timezones JSON column — fallback when no capital-city match exists.

Availability: All plans (Community and above). Only an API key is required.

Responses are cached server-side for 24 hours.

Known DST sampling limitation: standard and DST offsets are determined by sampling Jan 1 and Jul 1 of the current year, which is correct for almost every populated IANA zone. A small number of zones with non-standard DST windows (most notably Africa/Casablanca with Ramadan-based transitions) can report incorrect offset_utc / dst_offset_utc / is_dst_now values during their actual DST window. Use a dedicated timezone library if you need exact DST behaviour for those edge cases.

Authentication

X-CSCAPI-KEY · string · required

Your API key for authentication

Path Parameters

ciso · string · required

ISO 3166-1 alpha-2 code (e.g. US), alpha-3 code (e.g. USA), or numeric CSC country ID (e.g. 233). Case-insensitive for ISO codes.

Response

iana · string

Canonical IANA timezone name (e.g. "America/New_York"). Use this with any standards-compliant date/time library — JavaScript Intl, Python zoneinfo, Java ZoneId, etc.

abbreviation · string

Locale-aware short name at request time (e.g. "EST" in winter, "EDT" in summer). Display-only — not stable enough to use as an identifier.

offset_utc · string

Standard (non-DST) UTC offset in ±HH:MM form (e.g. "-05:00" for US Eastern).

dst_offset_utc · string

DST UTC offset in ±HH:MM form (e.g. "-04:00" for US Eastern Daylight). Equal to offset_utc for zones that don’t observe DST.

is_dst_now · boolean

Whether DST is in effect for this zone at request time. false when the zone doesn’t observe DST.

cURL (ISO2)

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

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

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

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

const tz = await response.json();
// Format current time in that zone
const local = new Date().toLocaleString('en-US', { timeZone: tz.iana });
console.log(`${tz.iana} | ${local} | DST: ${tz.is_dst_now}`);

import requests
from datetime import datetime
from zoneinfo import ZoneInfo

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

tz = response.json()
now_local = datetime.now(ZoneInfo(tz['iana']))
print(f"{tz['iana']} ({tz['abbreviation']}) — {now_local}")

200 - DST-observing country (in summer)

{
  "iana": "America/New_York",
  "abbreviation": "EDT",
  "offset_utc": "-05:00",
  "dst_offset_utc": "-04:00",
  "is_dst_now": true
}

{
  "iana": "Asia/Kolkata",
  "abbreviation": "GMT+5:30",
  "offset_utc": "+05:30",
  "dst_offset_utc": "+05:30",
  "is_dst_now": false
}

{
  "error": "Unauthorized. You shouldn't be here."
}

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

{
  "error": "No timezone data available for this country."
}

Related Endpoints

• Get Timezone by State — finer-grained timezone for federations / countries with multiple zones (US, Canada, Russia, Australia, etc.)
• Get Timezone by City — per-city precision
• Get Country Details — includes the raw timezones JSON column