Open Platform
Skip to content

Get the group list of an account ​

https://euapi.ttlock.com/v3/group/listWithLockNum

Returns only groups containing electronic keys or locks, the number of ungrouped electronic keys is returned with groupId=0.

Sort by group name

1 Request example ​

javascript
curl --location -g --request GET 'https://euapi.ttlock.com/v3/group/listWithLockNum?clientId=fd2ff35ee3d8424c8665c07b7b9a7f45&accessToken=780f7671b6e6be3010d9787f19207aca&date=1625025703000'

2 Request parameters ​

NameTypeRequiredDescription
clientIdStringYclient_id from Create application
accessTokenStringYAccess token,refer to: Get access token
keyRightIntNWhether to return only the group to which the ekey with administrative privileges belongs: no pass returns all, 1-returns those with administrative privileges, 0-returns ordinary user ekeys
dateLongYCurrent time (timestamp in millisecond)

3 Response and example ​

ParameterTypeDescription
listJSONArraylist of records

The objects in the list

ParameterTypeDescription
groupIdIntGroup ID, 0 means not grouped
nameStringGroup name(When groupId is 0, the group name is empty)
lockNumIntLock number
{
    "list": [
        {
            "groupId": 1342,
            "name":"The 4th floor",
            "lockNum": 2
        }
    ]
}
CopyRight © 2012-2026 TTLock.All Rights Reserved