API URL
GET /convert-time
Headers
Code
Content-Type: application/jsonQuery 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/LondonSuccessful Response
Status
HTML
200 OKBody
Code
{
"success": true,
"data": {
"original_datetime": "2026-04-06T15:30:00",
"original_timezone": "America/New_York",
"converted_datetime": "2026-04-06T20:30:00",
"converted_timezone": "Europe/London",
"utc_datetime": "2026-04-06T19:30:00Z",
"timezone_info": {
"from": {
"name": "America/New_York",
"abbreviation": "EDT",
"offset": "-04:00",
"dst": true
},
"to": {
"name": "Europe/London",
"abbreviation": "BST",
"offset": "+01:00",
"dst": true
}
}
},
"meta": {
"correlation_id": "conv_abc123",
"processing_time": "12ms",
"timestamp": "2026-04-06T19:30:00.000Z"
}
}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
meta
object
—
meta.correlation_id
string
—
meta.processing_time
string
—
meta.timestamp
string
—
error
string
—
Error Response
Example
Code
400 INVALID_TIMEZONE – Invalid timezone or location
400 MISSING_INPUT – Required parameter missing
500 SERVER_ERROR – Internal application errorLast Updated: May 4, 2026