get https://cloud.synaccess.com/api/v1/logs/banks
Access raw logging data of bank measurements over time.
The parameter since
must not be used with any of before
, after
, page
, and per_page
parameters. if since
is used, it will always return all events created since that time, ordered by their create time limited till 1000.
Example Bank Event Information
{
"id": 47,
"bank_id": "2001607",
"bank_name": "Primary Bank",
"enclosureSerialNumber": 1502530,
"energyAccumulation": 2.98,
"currentRms": 0.14,
"voltageRms": 118.2,
"lineFrequency": 60.19,
"powerFactor": 0.45,
"activePower": 7.71,
"apparentPower": 16.97,
"circuitBreakerClosed": true,
"hasCircuitBreakerProtection": true,
"deviceFirmware": "2.5.51-13-g997a1564",
"bankHw": "1.1.1",
"bankFw": "3.1.18",
"createdAt": "2022-08-13T22:58:37.264Z"
}
Key | Type | Description |
---|---|---|
id | integer | Unique identifier for this bank data point. |
bank_id | string | Bank ID this data point belongs to. This is unique to each bank of the PDU. |
bank_name | string | Custom bank name that is set by the user.. |
enclosureSerialNumber | integer | Serial Number of the PDU which this bank belongs to. |
currentRms | float | The instantaneous current measured at the inlet in Amps |
voltageRms | float | Instantaneous voltage reading at inlet and all outlets in volts |
lineFrequency | float | Line Frequency measurement valid from 45-65 GHz |
powerFactor | float | Power Factor reading. Value is signed value representing polarity of power factor |
activePower | float | Active Power measured in KW (kiloWatts). Power consumed by electrical resistance |
apparentPower | float | Power which is actually consumed or utilized |
energyAccumulation | float | Number of kilowatt hours accumulated. Can be used as billing unit for energy delivered |
circuitBreakerClosed | boolean | State of circuit breakers. true if circuit breaker is closed and providing power correctly. |
hasCircuitBreakerProtection | boolean | true if bank has a circuit breaker. Otherwise, it is false |
createdAt | string | Time in ISO format when the data point was saved to database |
bankHw | string | Hardware Version of the bank |
bankFw | string | Firmware Version of the bank |
deviceFirmware | string | Firmware of the control module |