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

{
  "iana": "America/Los_Angeles",
  "abbreviation": "PDT",
  "offset_utc": "-08:00",
  "dst_offset_utc": "-07: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.

Get the timezone for a specific city. The country and state codes in the path are not redundant — they’re enforced server-side as an ownership check: a city ID is only resolved if it actually belongs to the given state inside the given country. This prevents “city-ID spoofing” — a caller can’t learn the timezone of an arbitrary city by trying its ID under a different country/state pair.
Availability: All plans (Community and above). Only an API key is required.
Responses are cached server-side for 24 hours. The cache key includes country, state, and city ID, so the ownership check holds on cache HIT — a city ID looked up under one (ciso, siso) pair won’t satisfy a request under a different pair.

​
Authentication

​
X-CSCAPI-KEY
string
required
Your API key for authentication

​
Path Parameters

​
ciso
string
required
Country code: ISO 3166-1 alpha-2 (US), alpha-3 (USA), or numeric CSC ID. Case-insensitive.
​
siso
string
required
State/province code (e.g. CA for California). Case-insensitive.
​
city_id
integer
required
Numeric CSC city ID. Get this from /v1/countries/:ciso/states/:siso/cities or /v1/cities.

​
Response

Same shape as the country and state timezone endpoints:
​
iana
string
Canonical IANA timezone name (e.g. "America/Los_Angeles").
​
abbreviation
string
Locale-aware short name at request time.
​
offset_utc
string
Standard UTC offset in ±HH:MM form.
​
dst_offset_utc
string
DST UTC offset in ±HH:MM form.
​
is_dst_now
boolean
Whether DST is in effect at request time.
curl -X GET 'https://api.countrystatecity.in/v1/timezone/US/CA/24295' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

{
  "iana": "America/Los_Angeles",
  "abbreviation": "PDT",
  "offset_utc": "-08:00",
  "dst_offset_utc": "-07:00",
  "is_dst_now": true
}

​
Notes on city_id

The city_id is the same numeric ID returned by all list endpoints (/v1/countries/:ciso/states/:siso/cities, /v1/cities, etc.). If you stored a city ID in your own database, this endpoint is the canonical way to look up its timezone without re-fetching the full city record.