Skip to main content
POST
Submit device meter records

Authorizations

Authorization
string
header
required

Bearer token obtained from POST /auth/tokens.

Path Parameters

device_id
string
required

Flatpeak Device ID.

Example:

"dev_63a6087272941ef077a8fd3e"

Body

application/json
basis
enum<string>
required

INTERVAL records carry energy per period; CUMULATIVE records carry register readings.

Available options:
INTERVAL,
CUMULATIVE
Example:

"INTERVAL"

data
(Interval record · object | Cumulative record · object)[]
required

Meter records to submit, all of the same basis.

session_reference_id
string

A reference for a group of meter records, for example, a charging session ID.

Example:

"SESSION1234567890"

Response

200 OK: the status of a submitted meter record batch.

id
string
required

Flatpeak ID for this submission.

Example:

"mbr_65e42b7827c0526548432b9f"

object
enum<string>
required

Object type.

Available options:
meter_batch
Example:

"meter_batch"

records_submitted
integer
required

Number of received meter records.

Example:

18379

records_accepted
integer
required

Number of accepted meter records.

Example:

18378

records_processed
integer
required

Number of processed meter records.

Example:

32

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-11-07T05:31:56Z"

failed_records
FailedMeterRecord · object[]

Details of any meter records that failed processing.