API URL
GET /current-time
Headers
Code
Content-Type: application/jsonQuery Parameters
Param
Type
Description
target
required
string
IANA timezone identifier (e.g. America/New_York, UTC, Asia/Tokyo)
Example GET Request
Code
GET /api/v1/current-time?target=America/New_YorkSuccessful Response
Status
HTML
200 OKBody
Code
{
"success": true,
"data": {
"timezone": "America/New_York",
"current_time": "2026-04-06T15:30:45-04:00",
"utc_time": "2026-04-06T19:30:45Z",
"timezone_info": {
"name": "America/New_York",
"abbreviation": "EDT",
"offset": "-04:00",
"dst": true,
"dst_start": "2026-03-09T07:00:00Z",
"dst_end": "2026-11-01T06:00:00Z"
}
},
"meta": {
"correlation_id": "time_xyz789",
"processing_time": "8ms",
"timestamp": "2026-04-06T19:30:45.000Z"
}
}Field
Type
success
boolean
data
object
data.timezone
string
data.current_time
string
data.utc_time
string
data.timezone_info
object
meta
object
meta.correlation_id
string
meta.processing_time
string
meta.timestamp
string
error
string
Error Response
Example
Code
400 MISSING_TARGET – If the 'target' parameter is not provided
400 INVALID_TIMEZONE – If the provided timezone cannot be parsed by moment-timezoneLast Updated: May 4, 2026