Schema.

Every field returned by the World Time API, with types and examples.

# datetime — /timezone, /ip

  • abbreviationstring

    The abbreviated name of the timezone.

    e.g. EDT

  • datetimestring

    The current date and time.

    e.g. 2025-08-03T08:39:35.923-04:00

  • day_of_weekinteger

    Day of the week (0 = Sunday).

    e.g. 0

  • day_of_yearinteger

    Day of the year (1–366).

    e.g. 215

  • dstboolean

    Whether local time is currently in DST.

    e.g. true

  • dst_fromstring|null

    When 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:00

  • dst_offsetinteger

    DST offset in seconds.

    e.g. 3600

  • dst_untilstring|null

    When 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:00

  • raw_offsetinteger

    Offset from UTC in seconds, excluding DST.

    e.g. -18000

  • timezonestring

    IANA timezone identifier.

    e.g. America/New_York

  • unixtimeinteger

    Seconds since the Unix epoch.

    e.g. 1754224775

  • utc_datetimestring

    Current UTC date and time.

    e.g. 2025-08-03T12:39:35.923+00:00

  • utc_offsetstring

    UTC offset in ±HH:MM format.

    e.g. -04:00

  • week_numberinteger

    ISO week number (1–53).

    e.g. 31

  • client_ipstring

    IP address of the requesting client.

    e.g. 127.0.0.1

# geolocation — /geo

  • ipstring

    The IP address that was looked up.

    e.g. 8.8.8.8

  • latitudenumber|null

    Latitude coordinate.

    e.g. 37.386

  • longitudenumber|null

    Longitude coordinate.

    e.g. -122.084

  • accuracy_radiusinteger|null

    Accuracy radius in kilometers.

    e.g. 1000

  • timezonestring|null

    IANA timezone for the location.

    e.g. America/Los_Angeles

  • citystring

    City name.

    e.g. Mountain View

  • postal_codestring

    Postal / ZIP code.

    e.g. 94043

  • metro_codeinteger

    Metro code.

    e.g. 807

  • subdivisionsarray

    Subdivision objects { code, name }.

    e.g. [{"code":"CA","name":"California"}]

  • countryobject

    Country info: iso_code, name, is_in_european_union.

    e.g. {"iso_code":"US","name":"United States"}

  • continentobject

    Continent info: code, name.

    e.g. {"code":"NA","name":"North America"}

  • is_in_european_unionboolean

    Whether the IP is located in the EU.

    e.g. false

  • is_anonymous_proxyboolean

    Whether the IP is an anonymous proxy.

    e.g. false

  • is_satellite_providerboolean

    Whether the IP belongs to a satellite provider.

    e.g. false

  • is_anycastboolean

    Whether 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 — unixtime is seconds since 1970-01-01.
  • timezones — IANA Time Zone Database identifiers (e.g. America/New_York, Europe/London).