Open Platform
Skip to content

Water usage record list ​

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

1 Request example ​

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

json
curl --location -g --request POST 'https://euapi.ttlock.com/v3/waterMeter/listRecords' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'waterMeterId=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)
waterMeterIdStringYWater Meter ID
dateTypeIntYDate type, 0: day, 1: month, 2: year
dateStrStringYSearch criteria: 2024-09-06, 2024-09, or 2024

3 Response and example ​

NameTypeDescription
listJSONObjectList

Objects in the list

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