Statistics (Summary)

get

https://api.freedomrobotics.ai/accounts/{account}/devices/{device}/statistics/summary

This endpoint returns an aggregated summary of statistics for the specified device in the account.

Relative times:

now - Current time
-XXs - Number of seconds before now
-XXm - Number of minutes before now
-XXh - Number of hours before now
-XXd - Number of days before now
-XXw - Number of weeks before now
-XXM - Number of months before now
-XXY - Number of months before now

Path Params

account

string

required

device

string

required

Query Params

utc_start

string

Defaults to -1d

utc epoch timestamp as float, will return results after this time (inclusive). It will be always round to the hour so if you ask to -1h and is not in the exact minute 0, it will return the data from the past hour. If not present the default is the current day at hour 0. The limit you can request for it is 10 years in the past

utc_end

string

Defaults to now

utc epoch time as float, will return results until this time (inclusive). If not present the default is the current hour. The limit you can ask for it is 1 day in the future

statistics

string

Defaults to ["active"]

JSON list of strings of the statistic names to filter the results. If not present will return all by default.

grouping

string

required

Defaults to hour

must be one of hour, day, week, month, year, decides the bucket size to aggregate on.

Responses

Relative times:

200200

400400