Skip to content



Revision Date Description
1.22 11/10/2023 v2 endpoints locked down. Closed feedback period that started with v1.18
1.21 11/03/2023 Multiple response formats for recent measurements
1.20 10/31/2023 Metrics dictionary added
1.19 09/22/2023 Add example code for working with recent datasource measurements
1.18 08/17/2023 Stable v2 endpoints for Datasources, Subscriptions, Measurements
1.17 08/11/2023 Clarify where to find code and org in Clarity Dashboard
1.16 05/30/2023 Add location to response from /v2/devices/nodes(if the node is working)
1.15 05/4/2023 Removing /v1/readings as functionality is now available via more modern endpoints
1.14 04/24/2023 No changes, just added heads up comments of expected changes to v2 datasources and measurements
1.13 09/08/2022 Added v2 endpoints for device health and status
1.12 10/13/2021 Added Standard AQIs, Ozone and 24-hr rolling mean and NowCast aggregations
1.11 09/01/2021 Added windSpeed, windDirection to measurement response (when available)
1.10 01/20/2021 Added life stage explanation and reviewed descriptive language
1.9 01/18/2021 Added health status fields and node configuration to the repsonse of /devices API
1.8 08/28/2020 Enforce data subscriptions; Fix measurement start_time, end_time when timespan is hour or day
1.7 05/13/2020 Use ethreain API keys; The nodes user can access is managed by data subscription service
1.6 10/16/2019 Support serving gzip compressed data
1.5 09/25/2019 Added aqi query parameter to /measurements API
1.4 09/18/2019 Added /readings API
1.3 09/17/2019 Added enabledCharacteristics to Device; Reduced limit of list Measurement down to 5000
1.2 06/14/2019 Changed average description; Elaborated on the definition of time
1.1 06/04/2019 Fixed a few typos and Markdown syntax errors; Added elaborations on API improvements
1.0 06/03/2019 Initial publication