go-ring API Reference
OpenapiDevice History

Get a device timeline

Retrieves timeline events for a device within an optional time range.

GET
/evm/v2/timeline/devices/{device_id}

Authorization

RingAccessToken
AuthorizationBearer <token>

Send an OAuth access token in the Authorization: Bearer header. Token exchange and refresh operations are described under Authentication.

In: header

Path Parameters

device_id*integer
Formatint64
Range1 <= value

Query Parameters

start_time?string

Inclusive timeline start in RFC 3339 format; requiredness is not established.

Formatdate-time
end_time?string

Timeline end in RFC 3339 format; requiredness is not established.

Formatdate-time
order?string

Descending order was recorded; other values may be accepted.

limit?integer

Positive maximum number of results; 20 was recorded.

Range1 <= value
capabilities?string

Comma-separated capability tokens. Observed tokens are offline_event, vehicle and ringtercom; future tokens are possible.

Response Body

application/json

curl -X GET "https://example.com/evm/v2/timeline/devices/1"
{  "items": []}