API URL
GET /api/v1/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": {
"requested_location": "America/New_York",
"longitude": -74.006,
"latitude": 40.7128,
"datetime": "2026-06-09T10:30:00-04:00",
"timezone_name": "America/New_York",
"timezone_abbreviation": "EDT",
"gmt_offset": -4,
"is_dst": true
},
"meta": {
"correlationId": "req_abc123",
"timestamp": "2026-06-09T14:30:00.000Z",
"processingTime": "12ms"
}
}Field
Type
success
boolean
data
object
data.requested_location
string
data.longitude
number
data.latitude
number
data.datetime
string
data.timezone_name
string
data.timezone_abbreviation
string
data.gmt_offset
number
data.is_dst
boolean
meta
object
meta.correlationId
string
meta.timestamp
string
meta.processingTime
string
status
string
service
string
version
string
error
string
Error Response
Example
Code
400 ValidationError - Missing target query parameter: Lookup request rejected because target was not provided
400 ValidationError - Invalid target timezone value: Lookup request rejected because target timezone could not be resolved
401 AuthenticationError - Gateway authentication failure: Request rejected due to missing or invalid API credentials
404 NotFound - Unknown endpoint path: Request path does not map to available current-time routesLast Updated: May 4, 2026