Get single

Returns the door sensor with the specified id.

GET https://api.tedee.com/api/v1.33/my/doorsensor/{id}

URI Parameters

Name	Type	Description
id	number	id of the door sensor
includeUserSettings	boolean (optional)	should userSettings be included

Responses

Name	Type	Description
200 OK	Door sensor	successful operation

Scopes

Name	Description
Device.Read	Grants user possibility to read data connected with devices
Device.ReadWrite	Grants user possibility to read and write data connected with devices

Examples

Get single door sensor

Sample request for door sensor with id = 123

curl -X GET "https://api.tedee.com/api/v1.33/my/doorsensor/123?includeUserSettings=true" -H "accept: application/json" -H "Authorization: Bearer <<access token>>"

Sample response

HTTP status code: 200

{
    "result": {
        "userSettings": {
            "favorite": true
        },
        "connectedToLockId": 456,
        "deviceState": {
            "batteryLevel": 74,
            "batteryLevelModifiedTime": "2024-12-10T08:24:15"
        },
        "id": 123,
        "organizationId": 1,
        "serialNumber": "12345-67890",
        "name": "Door sensor Test",
        "userIdentity": "1234567890",
        "type": 8,
        "created": "2024-12-01T16:10:34",
        "revision": 1,
        "deviceRevision": 1,
        "targetDeviceRevision": 1,
        "timeZone": "Europe/Warsaw",
        "isConnected": null,
        "accessLevel": 2,
        "shareDetails": null,
        "softwareVersions": [
            {
                "softwareType": 0,
                "version": "1.0",
                "updateAvailable": false
            }
        ]
    },
    "success": true,
    "errorMessages": [],
    "statusCode": 200
}