Skip to main content
POST
Heartbeat

Authorizations

Authorization
string
header
required

Charger-side bearer token. Obtained by exchanging device_id and device_secret (issued at registration) at /v1/device/token. Valid for 24 hours.

Body

application/json
timestamp
string<date-time>
required
status
enum<string>
required
Available options:
online,
offline,
fault
fault_code
integer
required

0 = no fault; otherwise platform-defined code.

Response

200 - application/json

Heartbeat acknowledged. Pending commands may be returned.

Standard response envelope. code is 0 on success and a non-zero application code on error (see Error Codes — §14).

code
integer
required

0 = success; otherwise an error code per the Error Codes section.

message
string
required

Human-readable description.

data
object

Endpoint-specific payload.