Open Platform
Skip to content

Electricity usage record list ​

https://euapi.ttlock.com/v3/electricMeter/listRecords

1 Request example ​

POST, ContentType:application/x-www-form-urlencoded

json
curl --location -g --request POST 'https://euapi.ttlock.com/v3/electricMeter/listRecords' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'electricMeterId=3001' \
--data-urlencode 'date=1625025703000'

2 Request parameters ​

NameTypeRequiredDescription
clientIdStringYAssigned client_id from created application
accessTokenStringYAccess token, obtain by calling get access token API
dateLongYCurrent time (timestamp, in milliseconds)
electricMeterIdStringYElectricity meter ID
dateTypeIntYDate type, 0: day, 1: month, 2: year
dateStrStringYdateType = 0 indicates a query by day, and dateStr must be accurate to the day: 2024-09-06; dateType = 1 indicates a query by month, and dateStr must be accurate to the month: 2024-09; dateType = 2 indicates a query by year, and dateStr must be accurate to the year: 2024

3 Response and example ​

NameTypeDescription
listJSONObjectList

Objects in the list

NameTypeDescription
dateTypeIntDate type: 0: day, 1: month, 2: year
usedKwhStringElectricity consumption
createDateStringOperation time
json
{
    "list": [
        {
            "dateType": 2,
            "usedKwh": "0.00kWh",
            "createDate": "2025-06"
        }
    ]
}
CopyRight © 2012-2026 TTLock.All Rights Reserved