curl -X GET 'https://api.countrystatecity.in/v1/timezone/US/CA/24295' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
curl -X GET 'https://api.countrystatecity.in/v1/timezone/IN/MH/57614' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
const response = await fetch(
'https://api.countrystatecity.in/v1/timezone/US/CA/24295', // San Francisco
{ headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' } }
);
const tz = await response.json();
const localNow = new Date().toLocaleString('en-US', { timeZone: tz.iana });
console.log(`Current local time: ${localNow}`);
import requests
response = requests.get(
'https://api.countrystatecity.in/v1/timezone/US/NY/124394', # New York City
headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)
print(response.json()['iana']) # "America/New_York"
{
"iana": "America/Los_Angeles",
"abbreviation": "PDT",
"offset_utc": "-08:00",
"dst_offset_utc": "-07:00",
"is_dst_now": true
}
{
"error": "City not found."
}
{
"error": "No timezone data available for this city."
}
Timezones
Get Timezone by City
Retrieve the timezone for a specific city
GET
/
timezone
/
{ciso}
/
{siso}
/
{city_id}
curl -X GET 'https://api.countrystatecity.in/v1/timezone/US/CA/24295' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
curl -X GET 'https://api.countrystatecity.in/v1/timezone/IN/MH/57614' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
const response = await fetch(
'https://api.countrystatecity.in/v1/timezone/US/CA/24295', // San Francisco
{ headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' } }
);
const tz = await response.json();
const localNow = new Date().toLocaleString('en-US', { timeZone: tz.iana });
console.log(`Current local time: ${localNow}`);
import requests
response = requests.get(
'https://api.countrystatecity.in/v1/timezone/US/NY/124394', # New York City
headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)
print(response.json()['iana']) # "America/New_York"
{
"iana": "America/Los_Angeles",
"abbreviation": "PDT",
"offset_utc": "-08:00",
"dst_offset_utc": "-07:00",
"is_dst_now": true
}
{
"error": "City not found."
}
{
"error": "No timezone data available for this city."
}
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.
Notes on
The
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.
Response
Same shape as the country and state timezone endpoints:curl -X GET 'https://api.countrystatecity.in/v1/timezone/US/CA/24295' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
curl -X GET 'https://api.countrystatecity.in/v1/timezone/IN/MH/57614' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
const response = await fetch(
'https://api.countrystatecity.in/v1/timezone/US/CA/24295', // San Francisco
{ headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' } }
);
const tz = await response.json();
const localNow = new Date().toLocaleString('en-US', { timeZone: tz.iana });
console.log(`Current local time: ${localNow}`);
import requests
response = requests.get(
'https://api.countrystatecity.in/v1/timezone/US/NY/124394', # New York City
headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)
print(response.json()['iana']) # "America/New_York"
{
"iana": "America/Los_Angeles",
"abbreviation": "PDT",
"offset_utc": "-08:00",
"dst_offset_utc": "-07:00",
"is_dst_now": true
}
{
"error": "City not found."
}
{
"error": "No timezone data available for this city."
}
Related Endpoints
- Get Timezone by Country — country-level (uses the capital’s timezone)
- Get Timezone by State — state-level precision
- Get Cities by State — list cities to find the right city ID
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.Authorizations
API key for authentication. Get your free key at app.countrystatecity.in.
Path Parameters
ISO 3166-1 alpha-2 (e.g., US), alpha-3, or numeric country ID
Example:
"US"
State/province code (e.g., CA)
Example:
"CA"
Numeric city ID (from the cities endpoints)
Example:
24295
Response
Timezone information for the city
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.
Canonical IANA timezone identifier
Example:
"Asia/Kolkata"
Locale-aware short code (display only — not unique across timezones)
Example:
"IST"
Standard UTC offset in ±HH:MM format
Example:
"+05:30"
DST UTC offset in ±HH:MM format; equals offset_utc for zones without DST
Example:
"+05:30"
Whether DST is currently active
Example:
false