Date ranges

Some fields require you to pass in a date range. The notation for a date range is as follows [start-date,end-date).

Both the start date and the end date are optional. Omitting the start date will mean that all dates below the upper boundary are included in the range. Likewise, omitting the end date will mean that all dates greater than the lower date are included in the range. If both the start end end date are omitted the range all dates will be considered to be in the range.

An inclusive lower bound is represented by "[" while an exclusive lower bound is represented by "(". Likewise, an inclusive upper bound is represented by "]", while an exclusive upper bound is represented by ")".

A date should be formatted as YYYY-MM-DD.

[,]

An endless date range, from negative to positive infinity

[2026-01-01, 2027-01-01)

From january 1, 2026 until the last day of 2026. The ")" indicates up to excluding

[2026-01-01,)

From january 1, 2026 until the end of time

[2026-01-01,2026-01-02]

From january 1, 2026 up to including the january 2. The "]" indicates up to including

Last updated

Was this helpful?