Skip to main content

How dates and times are handled

The Sally API uses one format everywhere, in both directions: ISO-8601 in UTC with a trailing Z. This page lists the rules and the one trap to avoid when you filter by day.

2026-08-27T14:30:00Z

Quick navigation

  1. The rules
  2. Filtering by day

1. The rules​

  • Responses are always in UTC.
  • Inputs must be UTC. A value without a time zone suffix is read as UTC, never as server time.
  • An explicit offset is converted to the matching UTC instant, so 2026-08-27T16:30:00+02:00 is the same instant as the example above.
  • A date without a time (2026-08-27) counts as midnight UTC.

2. Filtering by day​

Important

In summer a day in Berlin starts two hours before midnight UTC, so from=2026-08-27 is not the German 27th. Convert on your side and send the exact instant you mean, for example 2026-08-26T22:00:00Z.