Overview

Transform your global time management with our comprehensive timezone conversion service. Whether you're coordinating international meetings, managing distributed teams, or building travel applications, this API eliminates the complexity of timezone calculations.

Perfect for travel booking platforms that need to display local arrival times, scheduling applications coordinating across multiple regions, and enterprise systems managing global operations. The service handles daylight saving transitions automatically and supports both major cities and precise IANA timezone identifiers.

Designed for developers who need reliable, accurate time data without the headache of maintaining timezone databases or handling regional variations. Simply provide your source and target locations, and receive perfectly formatted time conversions ready for display to your users.

API URL

GET /current-time; GET /convert-time

Headers

Code

Content-Type: application/json

Query Parameters

Param

Type

Description

sourceTime

optional

string

Time to convert (ISO 8601 or Unix ms). Defaults to current time.

sourceZone

required

string

Source IANA timezone identifier

targetZone

required

string

Target IANA timezone identifier

Example GET Request

Code

GET /api/v1/convert-time?sourceTime=2026-04-06T15:30:00&sourceZone=America/New_York&targetZone=Europe/London

Successful Response

Status

HTML

200 OK

Body

Code

{
  "base_location": {
    "datetime": "2025-12-31 12:00:00",
    "timezone_location": "America/New_York",
    "timezone_name": "EST",
    "gmt_offset": -5,
    "is_dst": false
  },
  "target_location": {
    "datetime": "2025-12-31 17:00:00",
    "timezone_location": "Europe/London",
    "timezone_name": "GMT",
    "gmt_offset": 0,
    "is_dst": false
  }
}

Field

Type

Description

success

boolean

base_location.datetime | string | Local datetime in the source timezone formatted as ISO 8601 string

data

object

base_location.timezone_location | string | Full IANA timezone identifier for the source location (e.g., "America/New_York")

data.original_datetime

string

base_location.timezone_name | string | Human-readable timezone abbreviation accounting for DST (e.g., "EST" or "EDT")

data.original_timezone

string

base_location.gmt_offset | number | Hours offset from UTC for the source timezone including DST adjustments

data.converted_datetime

string

base_location.is_dst | boolean | Indicates whether daylight saving time is currently active in the source timezone

data.converted_timezone

string

target_location.datetime | string | Converted datetime in the target timezone formatted as ISO 8601 string

data.utc_datetime

string

target_location.timezone_location | string | Full IANA timezone identifier for the target location

data.timezone_info

object

target_location.gmt_offset | number | Hours offset from UTC for the target timezone including DST adjustments

Error Response

Example

Code

400 INVALID_TIMEZONE â€“ Invalid timezone or location
400 MISSING_INPUT â€“ Required parameter missing
500 SERVER_ERROR â€“ Internal application error

Last Updated: May 4, 2026

DP.

API Documentation

API URL

GET /current-time; GET /convert-time

Example GET Request

Successful Response

Error Response

API URL

GET /current-time; GET /convert-time

sourceTimeoptionalstring

sourceZonerequiredstring

targetZonerequiredstring

Example GET Request

Successful Response

successboolean

dataobject

data.original_datetimestring

data.original_timezonestring

data.converted_datetimestring

data.converted_timezonestring

data.utc_datetimestring

data.timezone_infoobject

metaobject

meta.correlation_idstring

meta.processing_timestring

meta.timestampstring

errorstring

Error Response