Skip to main content
GET
/
v1
/
timezone
/
{ciso}
/
{siso}
curl -X GET 'https://api.countrystatecity.in/v1/timezone/US/CA' \
  -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 state/province within a country. Useful for federations or countries that span multiple zones — US states, Canadian provinces, Russian federal subjects, Australian states, etc.
Availability: All plans (Community and above). Only an API key is required.
Responses are cached server-side for 24 hours. The cache key includes both the country and state codes, so cross-country state-code collisions never cause cache poisoning.

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 in the country’s local subdivision system (e.g. CA for California within US-CA). Case-insensitive.

Response

Identical shape to /v1/timezone/:ciso:
iana
string
Canonical IANA timezone name (e.g. "America/Los_Angeles").
abbreviation
string
Locale-aware short name at request time (e.g. "PST" / "PDT").
offset_utc
string
Standard UTC offset in ±HH:MM form (e.g. "-08:00").
dst_offset_utc
string
DST UTC offset in ±HH:MM form (e.g. "-07:00"). Equal to offset_utc for zones that don’t observe DST.
is_dst_now
boolean
Whether DST is in effect at request time.
curl -X GET 'https://api.countrystatecity.in/v1/timezone/US/CA' \
  -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
}