Get Timezone by City

Retrieve the timezone for a specific city

GET /v1/timezone/{ciso}/{siso}/{city_id}

cURL (San Francisco, CA)

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"

200 - San Francisco (DST in summer)

{
  "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.

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 (San Francisco, CA)

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"

200 - San Francisco (DST in summer)

{
  "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.