Open Platform
Skip to content

Export unlock records ​

https://euapi.ttlock.com/v3/lockRecord/listForExport

Get the full amount of lock operation records for export.

The cloud only keeps the last six months of records, so only the last six months of records are allowed to be exported.

Because it is not paged, full-volume acquisition, the interface will be very heavy when there are a lot of records, so the interface has access frequency limitations: the interface limits a user to a maximum of 5 calls a minute, 100 times a day; a maximum of 500 calls a day for an application, more than the call frequency limit, it will return an error code: 30006.

1 Request example ​

javascript
curl --location --request GET 'https://euapi.ttlock.com/v3/lockRecord/listForExport?clientId=4773aa036f7f49c68d876bb4be85c80c&accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f&lockId=163377&startDate=1526674054000&endDate=1626674054000&date=1626674054000'

2 Request parameters ​

NameTypeRequiredDescription
clientIdStringYclient_id from Create application
accessTokenStringYAccess token,refer to: Get access token
lockIdIntYLock ID, generated by Lock init
startDateLongNStart time, search by operate time(timestamp in millisecond)
endDateLongNEnd time, search by operate time (timestamp in millisecond)
dateLongYCurrent time (timestamp in millisecond)

3 Response and example ​

ParameterTypeDescription
listJSONArraylist of records

The objects in the list

ParameterTypeDescription
lockIdIntLock ID
recordTypeFromLockIntRecord type from lock,refer to: Record type from lock
recordTypeIntRecord type, refer to: Record type from cloud for details
successIntIs success: 0-No, 1-Yes
usernameStringOperator account or username: APP user account for records of unlocking by APP password name for records of unlocking by passcodes Card name for records of unlocking by cards Fingerprint name for records of unlocking by fingerprints
keyboardPwdStringPasscode, card number or fingerprint number
dateLongOperate time on the lock (timestamp in millisecond).
{
    "list": [
        {
            "lockId": 163377,
            "recordTypeFromLock": 1,
            "recordType": 1,
            "success":1,
            "username": "alex@google.com",
            "date": 1616674054000},
        {
            "lockId": 163377,
            "recordTypeFromLock": 4,
            "recordType": 4,
            "success":1,
            "username": "小明",
            "keyboardPwd": "383834",
            "date": 1616675054000}
    ]
}
CopyRight © 2012-2026 TTLock.All Rights Reserved