Flip Energy API
  1. Telemetry
Flip Energy API
  • Overview
  • Important concepts
  • Authentication
  • Enrollment process
  • End-user app design
  • Monitoring / Telemetry
  • Control
  • Change log
  • Mobile App API
    • Devices
      • Create Device
      • Read Devices
      • Read Device
      • Update Device
      • Delete Device
    • Enrollments
      • Create Enrollment
      • Read Enrollments
      • Read Enrollment
      • Delete Enrollment
    • Events
      • Read Events
      • Read Event
      • Update Event Participation
    • Programs
      • Read Programs
      • Read Program
    • Sites
      • Read Site
      • Update Site
  • Cloud API
    • Sites
      • Get Site Token
      • Get Sites
    • Commissioning
      • Commission Site And Devices
    • Sessions
      • Sessions
    • Commands
      • Command Created
      • Update Command Status
    • Programs
      • Read Programs
    • Telemetry
      • Report Battery Telemetry
        POST
      • Report Battery Counter Telemetry
        POST
    • Webhooks
      • Overview
      • List of events
      • Webhook headers
      • Schemas
        • Command
        • Enrollment
        • Event
  1. Telemetry

Report Battery Counter Telemetry

Cloud Mock
https://mock.apidog.com/m1/479670-0-default
Cloud Mock
https://mock.apidog.com/m1/479670-0-default
POST
/v1/telemetry/BATTERY_COUNTER
Batch upload counter-based telemetry data points, with a maximum of 1,000 data points per request.
The /v1/telemetry/BATTERY endpoint accepts interval data (energy totals over a time period with duration_s and start_time), while /v1/telemetry/BATTERY_COUNTER accepts monotonically increasing counter values (cumulative lifetime energy readings with a timestamp).
Counter values are automatically converted to intervals by calculating deltas between consecutive readings: current_counter - previous_counter.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Example
{
    "telemetry": [
        {
            "start_time": "2019-08-24T14:15:22Z",
            "duration_s": 0,
            "device_id": "string",
            "last_is_online": true,
            "last_mode": "BACKUP",
            "battery_last_power_charge_w": 0,
            "battery_last_power_discharge_w": 0,
            "battery_energy_charge_wh_counter": 0,
            "battery_energy_discharge_wh_counter": 0,
            "battery_last_stored_energy_wh": 0,
            "battery_last_capacity_energy_wh": 0,
            "battery_last_state_of_charge_percentage": 0,
            "battery_last_state_of_health_percentage": 0,
            "is_weather_alarm_active": true,
            "last_is_grid_online": true,
            "home_energy_wh_counter": 0,
            "home_last_power_w": 0,
            "solar_energy_wh_counter": 0,
            "solar_last_power_w": 0,
            "grid_energy_wh_counter": 0,
            "grid_last_power_w": 0,
            "oem_raw_data": {}
        }
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://mock.apidog.com/m1/479670-0-default/v1/telemetry/BATTERY_COUNTER' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "telemetry": [
        {
            "start_time": "2019-08-24T14:15:22Z",
            "duration_s": 0,
            "device_id": "string",
            "last_is_online": true,
            "last_mode": "BACKUP",
            "battery_last_power_charge_w": 0,
            "battery_last_power_discharge_w": 0,
            "battery_energy_charge_wh_counter": 0,
            "battery_energy_discharge_wh_counter": 0,
            "battery_last_stored_energy_wh": 0,
            "battery_last_capacity_energy_wh": 0,
            "battery_last_state_of_charge_percentage": 0,
            "battery_last_state_of_health_percentage": 0,
            "is_weather_alarm_active": true,
            "last_is_grid_online": true,
            "home_energy_wh_counter": 0,
            "home_last_power_w": 0,
            "solar_energy_wh_counter": 0,
            "solar_last_power_w": 0,
            "grid_energy_wh_counter": 0,
            "grid_last_power_w": 0,
            "oem_raw_data": {}
        }
    ]
}'

Responses

🟢200OK
application/json
Body

Example
[
    {
        "status": "FAILED",
        "message": "string"
    }
]
🟠400Invalid input
🟠404Record not found
Modified at 2025-11-05 23:03:49
Previous
Report Battery Telemetry
Next
Overview
Built with