Skip to content
English
Submit a request
  • There are no suggestions because the search field is empty.

Analytics API: dateEnd Parameter for Aggregated Page Analytics

Enabling closed date-range filtering in the Tiled aggregated page analytics endpoint

1. Purpose & Scope

This article documents the addition of the dateEnd parameter to the Tiled aggregated page analytics API endpoint, released in v59.0.0. This parameter enables API consumers to define a closed date range for analytics queries, ensuring returned data is precisely bounded and reproducible across multiple query runs.

Scope: Developers and data teams consuming the Tiled Analytics API. Customers using third-party BI tools or data pipelines connected to the Tiled API.

2. Control Objective

The control objective is to ensure that analytics data returned by the API accurately represents only the time period specified by the caller. Without a dateEnd boundary, repeated queries for the same nominal period return different totals as new session data accumulates, creating data integrity issues for period-close reports and audit evidence exports.

3. Parameter Reference

Endpoint

GET /analytics/pages/aggregated

New Parameter

dateEnd

Type

String — ISO 8601 date format (YYYY-MM-DD)

Required

No — optional. If omitted, query returns data from dateStart to the current date at time of request.

Effect

Filters returned analytics to sessions and events on or before the specified date, producing a closed, reproducible result set.

Pair With

dateStart — use both to define a fully closed date range.

4. Example Request

GET /analytics/pages/aggregated?dateStart=2026-03-01&dateEnd=2026-03-31

This query returns aggregated page analytics for March 2026 only. Without dateEnd the same query on April 15 and April 30 would return different totals, making the result non-reproducible.

5. Impact on Reporting & Audit Evidence

• Period-close engagement reports now produce deterministic, reproducible totals for a defined window.

• Automated BI dashboards with scheduled refresh cycles no longer accumulate new data into historical periods.

• Analytics exports used as SOC 2 audit evidence for specific review windows are now bounded correctly.

Note: Updated Swagger / public API documentation for this parameter is published as part of v59.0.0. Refer to the Tiled Developer Portal for the full endpoint specification.

6. Change History

v1.0 — April 7, 2026

Initial article. Parameter shipped in Tiled v59.0.0 (TD-6616).