Skip to main content
GET
/
operator
/
charging-records
Query charging records
curl --request GET \
  --url https://api.telluspower.example.com/v1/operator/charging-records \
  --header 'Authorization: Bearer <token>'
{
  "code": 123,
  "message": "<string>",
  "data": {
    "total": 123,
    "page": 123,
    "size": 123,
    "items": [
      {
        "record_id": "rec_9x8y7z6w",
        "device_id": "dvc_a1b2c3d4e5f6",
        "connector_id": 1,
        "start_time": "2025-03-15T09:00:00Z",
        "end_time": "2025-03-15T10:30:00Z",
        "energy": 15.2,
        "max_power": 7.2,
        "avg_power": 6.8,
        "cost": 12.16,
        "meter_start": 12345.6,
        "meter_end": 12360.8,
        "vehicle_info": {
          "vin": "LVXFA394XJ1234567",
          "soc_start": 20,
          "soc_end": 90
        }
      }
    ]
  }
}

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

Query Parameters

​
device_id
string
​
connector_id
integer
Required range: x >= 1
​
start_time
string<date-time>
​
end_time
string<date-time>
​
page
integer
default:1

Page number (1-indexed).

Required range: x >= 1
​
size
integer
default:20

Results per page (max 100).

Required range: 1 <= x <= 100

Response

200 - application/json

Charging records 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.