Schema.
Every field returned by the World Time API, with types and examples.
# datetime — /timezone, /ip
abbreviationstringThe abbreviated name of the timezone.
e.g.
EDTdatetimestringThe current date and time.
e.g.
2025-08-03T08:39:35.923-04:00day_of_weekintegerDay of the week (0 = Sunday).
e.g.
0day_of_yearintegerDay of the year (1–366).
e.g.
215dstbooleanWhether local time is currently in DST.
e.g.
truedst_fromstring|nullWhen DST is active: when the current DST period started. When inactive: when the next DST period begins. null if the timezone does not observe DST.
e.g.
2025-03-09T07:00:00+00:00dst_offsetintegerDST offset in seconds.
e.g.
3600dst_untilstring|nullWhen DST is active: when the current DST period ends. When inactive: when the last DST period ended. null if the timezone does not observe DST.
e.g.
2025-11-02T06:00:00+00:00raw_offsetintegerOffset from UTC in seconds, excluding DST.
e.g.
-18000timezonestringIANA timezone identifier.
e.g.
America/New_YorkunixtimeintegerSeconds since the Unix epoch.
e.g.
1754224775utc_datetimestringCurrent UTC date and time.
e.g.
2025-08-03T12:39:35.923+00:00utc_offsetstringUTC offset in ±HH:MM format.
e.g.
-04:00week_numberintegerISO week number (1–53).
e.g.
31client_ipstringIP address of the requesting client.
e.g.
127.0.0.1
# geolocation — /geo
ipstringThe IP address that was looked up.
e.g.
8.8.8.8latitudenumber|nullLatitude coordinate.
e.g.
37.386longitudenumber|nullLongitude coordinate.
e.g.
-122.084accuracy_radiusinteger|nullAccuracy radius in kilometers.
e.g.
1000timezonestring|nullIANA timezone for the location.
e.g.
America/Los_AngelescitystringCity name.
e.g.
Mountain Viewpostal_codestringPostal / ZIP code.
e.g.
94043metro_codeintegerMetro code.
e.g.
807subdivisionsarraySubdivision objects { code, name }.
e.g.
[{"code":"CA","name":"California"}]countryobjectCountry info: iso_code, name, is_in_european_union.
e.g.
{"iso_code":"US","name":"United States"}continentobjectContinent info: code, name.
e.g.
{"code":"NA","name":"North America"}is_in_european_unionbooleanWhether the IP is located in the EU.
e.g.
falseis_anonymous_proxybooleanWhether the IP is an anonymous proxy.
e.g.
falseis_satellite_providerbooleanWhether the IP belongs to a satellite provider.
e.g.
falseis_anycastbooleanWhether the IP is an anycast address.
e.g.
false
# formatting notes
- iso 8601 — all datetime fields use
YYYY-MM-DDTHH:MM:SS.ssssss±HH:MM. - unix epoch —
unixtimeis seconds since 1970-01-01. - timezones — IANA Time Zone Database identifiers (e.g.
America/New_York,Europe/London).