Skip to content
HALOWERK

Mobility, Warnings and Local Data

zone offset observation shortlist

Timezone identification returns candidate zones consistent with two observed timestamp offsets. Use it when an agent needs to narrow an unknown time zone using seasonal clock behavior.

POST https://ort.halowerk.com/v1/zone-offset-observation-shortlist

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
zonesarrayYes
firststringYes
secondstringYes
offset1integerYes
offset2integerYes
Show full input schema
{
  "type": "object",
  "properties": {
    "zones": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 80,
        "minLength": 1
      },
      "maxItems": 20,
      "minItems": 1
    },
    "first": {
      "type": "string",
      "maxLength": 42,
      "minLength": 1
    },
    "second": {
      "type": "string",
      "maxLength": 42,
      "minLength": 1
    },
    "offset1": {
      "type": "integer",
      "minimum": -840,
      "maximum": 840
    },
    "offset2": {
      "type": "integer",
      "minimum": -840,
      "maximum": 840
    }
  },
  "required": [
    "zones",
    "first",
    "second",
    "offset1",
    "offset2"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "zones": [
    "Europe/Berlin",
    "Africa/Lagos"
  ],
  "first": "2026-03-01T08:00:00Z",
  "second": "2026-07-01T12:00:00Z",
  "offset1": 60,
  "offset2": 120
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-19 UTC.

More endpoints in this hub

All endpoints in this hub โ†’