curl -X GET 'https://api.countrystatecity.in/v1/timezone/US' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl -X GET 'https://api.countrystatecity.in/v1/timezone/IND' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl -X GET 'https://api.countrystatecity.in/v1/timezone/233' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

const response = await fetch('https://api.countrystatecity.in/v1/timezone/US', {
  headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});

const tz = await response.json();
// Format current time in that zone
const local = new Date().toLocaleString('en-US', { timeZone: tz.iana });
console.log(`${tz.iana} | ${local} | DST: ${tz.is_dst_now}`);

import requests
from datetime import datetime
from zoneinfo import ZoneInfo

response = requests.get(
  'https://api.countrystatecity.in/v1/timezone/IN',
  headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)

tz = response.json()
now_local = datetime.now(ZoneInfo(tz['iana']))
print(f"{tz['iana']} ({tz['abbreviation']}) — {now_local}")

{
  "iana": "America/New_York",
  "abbreviation": "EDT",
  "offset_utc": "-05:00",
  "dst_offset_utc": "-04:00",
  "is_dst_now": true
}

{
  "iana": "Asia/Kolkata",
  "abbreviation": "GMT+5:30",
  "offset_utc": "+05:30",
  "dst_offset_utc": "+05:30",
  "is_dst_now": false
}

{
  "error": "Unauthorized. You shouldn't be here."
}

{
  "error": "Country not found."
}

{
  "error": "No timezone data available for this country."
}