Skip to main content
The Lemma API uses ISO 8601 timestamps for all date and time values. This is the most widely supported timestamp format across programming languages and tools.

Format

An ISO 8601 timestamp looks like this:

Timezone offsets

Instead of Z, you can specify a UTC offset:
This represents 9:30 AM Eastern Standard Time (UTC-5). The API converts all timestamps to UTC internally.

Using timestamps in query parameters

When filtering by timestamp, pass the full ISO 8601 string as the parameter value:
A value that isn’t valid ISO 8601 is rejected with a 400 error.

Date-only values

Filters also accepts a bare calendar date like 2026-03-15.
All of March, including March 1 and March 31
Bare dates are always UTC. To report on a period anchored to another timezone, pass explicit timestamps instead. A date that doesn’t exist, such as 2026-02-31, is rejected with a 400 error.

Generating timestamps