Skip to main content
POST
Submit a device state

Authorizations

Authorization
string
header
required

Bearer token obtained from POST /auth/tokens.

Path Parameters

device_id
string
required

Flatpeak Device ID.

Body

application/json

The current operational state of a device, grouped by subsystem. Include only the subsystems the device has. At least one subsystem block must be present.

time_recorded
string<date-time>
required

Time the measurement was recorded, in RFC 3339 format.

Example:

"2026-02-01T10:30:00Z"

record_reference_id
string

Optional unique identifier for the telemetry record, used for idempotency and reconciliation.

Example:

"MET1234567890"

battery
DeviceStateBattery · object

Operational state of a stationary battery.

vehicle
DeviceStateVehicle · object

Operational state of an electric vehicle.

evse
DeviceStateEvse · object

Operational state of an EV charge point.

pv
DeviceStatePv · object

Operational state of solar generation.

Response

Device state response.

device_id
string
required

Flatpeak Device ID.

Example:

"dev_6563a6757360a6d6a628e839"

id
string
required

Flatpeak device state record ID.

Example:

"dsr_6a284b7596d3f2b722544e70"

account_id
string
required

Flatpeak Account ID.

Example:

"acc_661677911f2197045e6cf1b1"

time_created
string<date-time>
required

Time when this object was created. In UTC.

Example:

"2026-02-01T10:33:00Z"

object
string

Object type.

Example:

"device_state"