Skip to main content
POST
/
device
/
events
Event reporting
curl --request POST \
  --url https://api.telluspower.example.com/v1/device/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "timestamp": "2025-03-15T10:36:00Z",
  "event_type": "fault",
  "connector_id": 1,
  "data": {
    "fault_code": 1001,
    "fault_message": "Overcurrent protection",
    "details": {
      "current": 40.5,
      "threshold": 32
    }
  }
}
'

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
​
event_type
enum<string>
required
Available options:
plug_in,
plug_out,
start,
stop,
fault,
alarm
​
connector_id
integer
required
Required range: x >= 1
​
data
object
required

Event-specific payload. For example:

  • plug_in: { vehicle_connected: boolean }
  • fault: { fault_code: int, fault_message: string, details: object }
  • start / stop: { reason: string }

Response

200

Event accepted.