Documentation

API URL


GET /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": {
    "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"
  }
}

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-timezone

Last Updated:  May 4, 2026