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

Response

Identical shape to /v1/timezone/:ciso:

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., US), alpha-3 (e.g., USA), or numeric country ID

Example:

"US"

siso
string
required

State/province code in local subdivision format (e.g., CA for California)

Example:

"CA"

Response

Timezone information for the state

IANA timezone with current UTC offset and DST status. Standard and DST offsets are sampled from Jan 1 and Jul 1 of the current year.

iana
string
required

Canonical IANA timezone identifier

Example:

"Asia/Kolkata"

abbreviation
string
required

Locale-aware short code (display only — not unique across timezones)

Example:

"IST"

offset_utc
string
required

Standard UTC offset in ±HH:MM format

Example:

"+05:30"

dst_offset_utc
string
required

DST UTC offset in ±HH:MM format; equals offset_utc for zones without DST

Example:

"+05:30"

is_dst_now
boolean
required

Whether DST is currently active

Example:

false