Batch circuit power

get

https://api.verdigris.co/data/v4/power/circuits

Gets average power data for multiple circuits in a single batch request. Units are in watts (SI unit: W).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📘
Notes

Since power is an instantaneous figure that represents the rate of energy consumption in a given time, the power values returned by this endpoint is averaged for given time interval.
For example, 15-minutely data will return an aggregated average of 15 individual minutely average power values. This will smooth out peaks and dips for 15-minutely data compared to minutely data.

Power endpoint first sorts data by full or partial, and then by the timestamp.

Query Params

ids

array of integers

required

length ≥ 1

An array of circuit IDs separated by commas.

ids*

interval

string

enum

required

Interval between each data points. Affects the validity of start_time, end_time query parameters, time resolution and aggregation of results.

For example, given the time range query parameters, start_time=2020-01-01T12:30:00Z&end_time=2020-01-01T13:00:00Z:

interval=1m: returns 30 data points at minutely resolution.
interval=15m: returns 2 data points at 15-minutesly/quarter-hourly resolution.

The ordering of timestamps is not guaranteed.

Allowed:

start_time

date-time

required

Start of the query time range. Value must be in ISO 8601 format.

Note that validity of start_time changes depending on the interval query parameter.

For example:

VALID: start_time=2020-01-01T12:34:00Z&interval=1m
VALID: start_time=2020-01-01T12:45:00Z&interval=15m
VALID: start_time=2020-01-01T13:00:00Z&interval=1h
VALID (if building’s timezone is in Pacific Standard Time):
- start_time=2020-01-01T08:00:00Z&interval=1d (UTC)
- start_time=2020-01-01T00:00:00+08:00&interval=1d (PST)
NOT VALID: start_time=2020-01-01T12:34:00Z&interval=15m
NOT VALID: start_time=2020-01-01T12:59:00Z&interval=1h
NOT VALID (if building’s timezone is in Pacific Standard Time):
- start_time=2020-01-01T00:00:00Z&interval=1d
- start_time=2020-01-01T04:00:00+08:00&interval=1d

end_time

date-time

required

End of the query time range. Value must be in ISO 8601 format.

Note that validity of end_time changes depending on the interval query parameter.

For example:

VALID: end_time=2020-12-31T12:34:00Z&interval=1m
VALID: end_time=2020-12-31T12:45:00Z&interval=15m
VALID: end_time=2020-12-31T13:00:00Z&interval=1h
VALID (if building’s timezone is in Pacific Standard Time):
- end_time=2020-12-31T08:00:00Z&interval=1d (UTC)
- end_time=2020-12-31T00:00:00+08:00&interval=1d (PST)
NOT VALID: end_time=2020-12-31T12:34:00Z&interval=15m
NOT VALID: end_time=2020-12-31T12:59:00Z&interval=1h
NOT VALID (if building’s timezone is in Pacific Standard Time):
- end_time=2020-12-31T00:00:00Z&interval=1d
- end_time=2020-12-31T04:00:00+08:00&interval=1d

timestamp_format

string | null

enum

Format timestamps in the data. If set to ISO8601 (case-insensitive), the timestamp is returned as a string formatted in ISO 8601 format. If omitted, the timestamp is returned as an integer representing UNIX epoch.

Allowed:

timezone

string

Defaults to UTC

When used in conjunction with timestamp_format query parameter that is set to ISO8601 format, specifying the zone ID of IANA Time Zone Database returns the timestamp in the time zone offset.

Setting the timezone when timestamp_format is not specified has no affect on the UNIX epoch timestamp.

📘
Note
This query parameter meant to be a convenience feature that only affects the display format of the timestamps in the result. It has no affect on the building’s timezone.

override_phase

string

enum

⚠️
Warning
This query parameter is intended for advanced users troubleshooting potentially incorrect data. Incorrect use of this query parameter can lead to erroneous data.

Overrides the configured phase for this circuit and returns the data as if the circuit was on the specified phase.

When omitted, the circuit will reference the phase based on the current panel configuration.

Allowed:

override_sensor_orientation

string

enum

⚠️
Warning
This query parameter is intended for advanced users troubleshooting potentially incorrect data. Incorrect use of this query parameter can lead to erroneous data.

Overrides the configured sensor orientation to return circuit data as if the CT was clamped upside down and flip positive values to negative and vice versa.

When omitted, the API will compute the data by referencing the sensor orientation based on the current panel configuration.

Allowed:

Notes

Note

Warning

Warning

200Power data for given time range. The ordering of timestamps is not guaranteed.

401Request to resource is unauthorized. This is likely due to missing access token in the Authorization header or an invalid token signature usually as a result of attempted token forgery by an unauthorized third-party.

403Request to resource is forbidden due to insufficient permissions.

404Resource with given ID cannot be found.

422One or more validations for request has failed.