Reports what this instance held, per day.

GET

/api/v1/admin/stats/history

Recorded by the hourly sweep, so history starts when this version is first deployed: shares swept before then are gone, sizes included. A day's entry is that day's last sweep.

Errors

400 when a date is not YYYY-MM-DD, from is after to, or the range is longer than 366 days; 401, 403 and 404 as /admin/stats.

Authorization

session

cookietessera_session<token>

Set by POST /auth/login. A browser sends it automatically; it is HttpOnly, so page scripts cannot read or set it.

Query Parameters

from?string

The first day, YYYY-MM-DD in UTC. Defaults to 29 days before to, giving thirty days.

to?string

The last day, YYYY-MM-DD in UTC, included. Defaults to today.

Response Body

What this instance held, a day at a time

application/json

response

Days of history, oldest first.

data*array<>

One per recorded day in the range. Days the server was not running have no entry, and history starts the day this version was first deployed.

curl -X GET 'https://example.com/api/v1/admin/stats/history?from=2026-09-01&to=2026-09-30'

{  "data": [    {      "bytes_served": 0,      "date": "string",      "live_shares": 0,      "shares": 0,      "stored_bytes": 0    }  ]}