Stream time-series data for a form
GET/timeseries/forms/:formId/stream
Resolves the signal group of the given form and streams its time series as newline-delimited JSON (application/x-ndjson), one row per timestamp carrying each signal's value, optionally aggregated by the given aggregation type. Unlike on the sibling streams, startDate and endDate are optional here: an absent start is the oldest data point stored for the group's metrics, an absent end the newest, so a request naming neither streams every available data point - the form export's default. The bounds actually read are the ones GET /timeseries/group/{signalGroupId}/metadata reports for the same request.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- default
OK. If the stream breaks off after its first lines were sent - the status is already 200 - it ends with one TimeseriesStreamErrorDto line instead of a data point (HET-1985). A reader that meets a line with an error member has an incomplete series, not a short one.
the default error response
Unauthorized — the bearer token is missing, expired or invalid, or carries no role. Errors raised by the security aspects contain an ErrorDto body; requests rejected by the security filter chain may have an empty body.
Forbidden — the authenticated user lacks the required role or access rights.
Entity not found.
the default error response