POST AI agent ready /v1/timezone

Timezone API - Free Current Time Lookup

Returns the current time, UTC offset, abbreviation, and DST status for a given IANA timezone. Defaults to UTC if no timezone is specified.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/timezone \
  -H "Content-Type: application/json" \
  -d '{"timezone":"America/New_York"}'

When to use this API

Display localized clocks in a dashboard

Build a multi-timezone clock widget for a team dashboard. Call this endpoint for each team member's timezone (e.g. America/New_York, Europe/Berlin, Asia/Tokyo) and render the current local time alongside their name.

Schedule notifications at local business hours

Before sending a push notification or email, check the recipient's timezone to confirm it is between 9am and 6pm local time. Delay delivery until the next business window to improve open rates and avoid off-hours interruptions.

Frequently asked questions

What timezone format does this endpoint accept?

It accepts IANA timezone identifiers like America/New_York, Europe/London, or Asia/Tokyo. The full list is maintained at iana.org/time-zones.

Does the response account for daylight saving time?

Yes. The is_dst field indicates whether DST is active, and the utc_offset reflects the current offset including any DST adjustment.

What happens if I pass an invalid timezone?

The endpoint returns a 400 error with a message explaining that the timezone identifier is not recognized.

Can I use this to get the current UTC time?

Yes. Either omit the timezone parameter (defaults to UTC) or explicitly pass "UTC" to get the current Coordinated Universal Time.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.