Documentation

API URL


GET /api/v1/current-time

Headers
Code
Content-Type: application/json
Query Parameters


Example GET Request

Code
GET /api/v1/current-time?target=America/New_York

Successful Response

Status
HTML
200 OK
Body
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"
  }
}

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 routes

Last Updated:  May 4, 2026