Skip to main content
GET
/
v1
/
timezone
/
{ciso}
curl -X GET 'https://api.countrystatecity.in/v1/timezone/US' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

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

Documentation Index

Fetch the complete documentation index at: https://docs.countrystatecity.in/llms.txt

Use this file to discover all available pages before exploring further.

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 -X GET 'https://api.countrystatecity.in/v1/timezone/US' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

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