Skip to content

Table of contents

Cozy Time Series doctype


The io.cozy.timeseries.* doctype is used to represent time series. The type of the time series is specified in the last part of the doctype, e.g. io.cozy.timeseries.geojson.

Any type of time series must follow the same common structure:

  • startDate: {date} the starting date of the time series.
  • endDate: {date} the ending date of the time series.
  • title: {string} the title of the time serie.
  • source: {string} the data source, e.g. “”.
  • theme: {string} a theme is used to group several types of time series into a common theme, e.g. “activity”.
  • series: {Array} the actual time series. The array contains objects and the format of each object depends on the data type of the time series.


These time series follow the GeoJSON format. See here for a complete example of this doctype.


  "startDate": "2021-02-17T17:37:17",
  "endDate": "2021-02-17T17:54:50",
  "source": "",
  "theme": "timeline",
  "series": [
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [48.85, 2.29]
      "properties": {
        "name": "Eiffel Tower"