go-ring API Reference
OpenapiRecordings

List doorbell recordings

Retrieves recordings associated with a doorbell, with optional filters and pagination.

GET
/clients_api/doorbots/{device_id}/history

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

limit?integer

Positive maximum number of results; 20 was recorded.

Range1 <= value
kind?string

History category. Known values include ding, motion, and on_demand.

older_than?integer

Returns history older than this Unix timestamp, when supported.

Formatint64
Range0 <= value

Response Body

application/json

application/json

curl -X GET "https://example.com/clients_api/doorbots/1/history"
[  {    "id": 1,    "kind": "ding",    "answered": false,    "created_at": "2025-01-01T00:00:00Z",    "doorbot": {      "id": 1    }  }]