Get historical telemetry

Returns telemetry data points for a time range. Each data point covers one interval per device with battery, solar, grid, and home metrics.

Authorization

AuthorizationBearer <token>

API key passed as a Bearer token. Contact your Flip account manager to obtain credentials.

In: header

Request Body

device_ids?array<string>

Filter to specific device IDs. If omitted, returns telemetry for all devices in the program.

end_timestring

ISO 8601 end of the time range.

Formatdate-time

program_idstring

Your program identifier.

start_timestring

ISO 8601 start of the time range.

Formatdate-time

Response Body

curl -X POST "https://api-utility.flip.energy/v1/telemetry/historical" \
  -H "Content-Type: application/json" \
  -d '{
    "end_time": "2019-08-24T14:15:22Z",
    "program_id": "string",
    "start_time": "2019-08-24T14:15:22Z"
  }'

curl -X POST "https://api-utility.flip.energy/v1/telemetry/historical" \  -H "Content-Type: application/json" \  -d '{    "end_time": "2019-08-24T14:15:22Z",    "program_id": "string",    "start_time": "2019-08-24T14:15:22Z"  }'

{
  "telemetry": [
    {
      "battery_last_backup_reserve_percentage": 0,
      "battery_power_charge_w": 0,
      "battery_power_discharge_w": 0,
      "battery_state_of_charge_percentage": 0,
      "battery_total_energy_charge_wh": 0,
      "battery_total_energy_discharge_wh": 0,
      "device_id": "string",
      "duration_s": 0,
      "grid_power_w": 0,
      "grid_total_energy_wh": 0,
      "home_power_w": 0,
      "home_total_energy_wh": 0,
      "last_is_online": true,
      "last_mode": "CHARGE",
      "solar_power_w": 0,
      "solar_total_energy_wh": 0,
      "start_time": "2019-08-24T14:15:22Z"
    }
  ]
}

{
  "code": "string",
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ],
  "errors": [
    {
      "message": "string",
      "path": "string"
    }
  ],
  "message": "string",
  "status_code": 0
}

{
  "code": "string",
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ],
  "errors": [
    {
      "message": "string",
      "path": "string"
    }
  ],
  "message": "string",
  "status_code": 0
}

{
  "code": "string",
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ],
  "errors": [
    {
      "message": "string",
      "path": "string"
    }
  ],
  "message": "string",
  "status_code": 0
}