UTILITY
Current Time API
/timeGet the current time in UTC or a named IANA time zone.
No signup or API key required.
Parameters
timezonestringoptional · query- IANA time zone, such as America/Los_Angeles. Up to 64 characters. Omit for UTC.
formatenumoptional · query- Response format. Defaults to json.
jsontext
No request body. Unknown or repeated query parameters return HTTP 400.
Returns 200 OK
A JSON object with the following fields.
timestring- Current ISO 8601 timestamp. UTC by default, or with the selected zone’s current offset and daylight-saving adjustment.
timezonestring- The supplied IANA time zone. Present only when timezone is supplied.
Plain text
With format=text: Only the ISO 8601 timestamp, without the timezone field.
Errors
Validation and service errors always return JSON, including when format=text.
errorstring- A machine-readable error code, such as invalid_parameter or rate_limited.
messagestring- A description of the problem.
400 Invalid parameters.
414 Query string exceeds 2048 characters.
429 Rate limit reached. Wait the seconds in Retry-After before retrying.
Usage notes
UTC by default. Optional timezone: an IANA name up to 64 characters, e.g. /time?timezone=America/Los_Angeles or Asia/Kolkata. Returns ISO 8601 with the current UTC offset, including daylight saving, plus timezone. Text returns only the time. Invalid zones return 400.
Show a timestamp for a selected city by supplying its IANA zone, such as America/Los_Angeles. The returned offset reflects daylight saving at the time of the request.
Responses are not cached. Browser requests are supported through open CORS.
120 requests per minute per IP, with up to 30 per 10 seconds, shared across APIs. Limits are approximate per Cloudflare location. Full usage limits ↗