List state changes, newest first
GET
/api/v1/history
Requires an API key with the read or write role. Each page reads at
most 12 monthly partitions. A sparse page may have no items and still
have a continuationToken; follow it until it is absent, keeping the
same date range and filters. Reversed date ranges and invalid
continuation cursors return 400.
Authorizations
bearerAuth
An API key issued by the Pixelbar board. A read key can fetch history; a write key can also change the state.
Type
HTTP (bearer)
Parameters
Query Parameters
from
Only entries at or after this time.
Type
string
Format
"date-time"to
Only entries at or before this time.
Type
string
Format
"date-time"device
Only entries from this legacy device shortname.
Type
string
limit
Page size. Values above 200 are clamped to 200.
Type
integer
Minimum
1Default
50Maximum
200continuationToken
Opaque token from a previous page's continuationToken.
Type
string
Responses
A page of history, possibly empty with a continuation token.
application/json
JSON "items": [ { "state": "open", "user": "your-name", "method": "button", "deviceShortname": "frontdoor", "source": "api", "changedAt": "2026-10-18T19:04:11.000Z" } ], "continuationToken": "1!52!RGF0ZQ--"
{
}