/bff/iot-lock/lock-electric-quantity-list

Returns the history of battery level (electric quantity) readings for a specific lock. Each entry records the battery percentage at a given point in time. Useful for monitoring battery health trends and predicting when replacement is needed.

IoTgetBffIot-lockLock-electric-quantity-list

Parameters

1 query

Query parameters

· 1

idstringRequired

TTLock lock ID (from TTLock API).

Example12345

Response schema

1 status code documented

200Success

itemsobject[]Required

Array of battery level readings ordered by date.

Each array item:

Single battery level measurement.

idnumberRequired

Record ID.

quantitynumberRequired

Battery level percentage (0–100) at the time of measurement.

insertedDateDate | string | string | numberRequired

Date when the measurement was recorded.

One of 4:

Variant 1

Date

Date when the measurement was recorded.

Variant 2

stringdate-time

Variant 3

stringdate

Variant 4

number

itemCountnumberRequired

Total number of battery level records.

Response example

application/json

{
  "items": [
    {
      "id": 0,
      "quantity": 0
    }
  ],
  "itemCount": 0
}

Request example

GET /bff/iot-lock/lock-electric-quantity-list

get

curl -X GET "https://api.bizkithub.com/bff/iot-lock/lock-electric-quantity-list?id=12345" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key