Skip to main content
GET
/
operator
/
devices
/
{device_id}
Get charger details
curl --request GET \
  --url https://api.telluspower.example.com/v1/operator/devices/{device_id} \
  --header 'Authorization: Bearer <token>'
{
  "code": 123,
  "message": "<string>",
  "data": {
    "device_id": "dvc_a1b2c3d4e5f6",
    "sn": "SN1234567890",
    "model": "AC-7kW-V2",
    "manufacturer": "ChargeTech",
    "firmware_version": "2.1.0",
    "status": "online",
    "connectors": [
      {
        "connector_id": 1,
        "status": "charging",
        "power": 6.8,
        "current": 30.5,
        "voltage": 223,
        "energy_delivered": 12.3,
        "soc": 55,
        "temperature": 38,
        "last_telemetry_time": "2025-03-15T11:00:00Z"
      }
    ],
    "last_heartbeat": "2025-03-15T11:00:00Z",
    "site_id": "site_001"
  }
}

Authorizations

​
Authorization
string
header
required

OAuth2 client-credentials grant for operator-side integrations. Obtain an access token by POSTing client_id and client_secret to /v1/operator/oauth/token. Tokens are valid for 24 hours (86,400 seconds).

Path Parameters

​
device_id
string
required

Response

Device 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.

Example:
{
  "device_id": "dvc_a1b2c3d4e5f6",
  "sn": "SN1234567890",
  "model": "AC-7kW-V2",
  "manufacturer": "ChargeTech",
  "firmware_version": "2.1.0",
  "status": "online",
  "connectors": [
    {
      "connector_id": 1,
      "status": "charging",
      "power": 6.8,
      "current": 30.5,
      "voltage": 223,
      "energy_delivered": 12.3,
      "soc": 55,
      "temperature": 38,
      "last_telemetry_time": "2025-03-15T11:00:00Z"
    }
  ],
  "last_heartbeat": "2025-03-15T11:00:00Z",
  "site_id": "site_001"
}