API URL
GET /api/v1/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
sourceLocation
optional
string
Source location resolved to timezone
targetLocation
optional
string
Target location resolved to timezone
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": {
"base_location": {
"datetime": "2025-12-31 07:00:00"
},
"target_location": {
"datetime": "2025-12-31 12:00:00"
}
},
"meta": {
"correlationId": "abc123",
"timestamp": "2026-06-05T00:00:00.000Z",
"processingTime": "42ms"
}
}Field
Type
success
boolean
data
object
data.base_location
object
data.target_location
object
data.datetime
string
data.timezone_name
string
data.timezone_location
string
data.timezone_abbreviation
string
data.gmt_offset
number
data.is_dst
boolean
data.requested_location
string
data.latitude
number
data.longitude
number
meta
object
meta.correlationId
string
meta.timestamp
string
meta.processingTime
string
error
string
Error Response
Example
Code
400 MissingParameters - Missing source or target conversion inputs on convert-time: Request rejected due to incomplete conversion inputs
400 InvalidTimezone - Invalid IANA timezone supplied: Request rejected due to timezone validation failure
400 InvalidCurrentTimeInput - Missing or invalid timezone or location on current-time route: Request rejected due to invalid current-time inputs
404 EndpointNotFound - Route does not match a declared endpoint: Request path is not supported
500 InternalError - Unhandled conversion or data-access exception: Request failed due to runtime processing errorLast Updated: May 4, 2026