Keely for developers

Series

One metric over a range, one point per date, up to a year at a time.

Updated November 6, 2026

On this page

GET /v1/series/{metric}

GET `/v1/series/{metric}`

Scope: nights or days, by metric
Path: metric, one of the table’s
Query: from, to (YYYY-MM-DD), at most 366 days; the last 30 by default

One metric over a range, one point per date, null for dates without data, with stats over the dates that have one. The scope depends on the metric:

Metric	Unit	Scope
`recovery`	%	`nights`
`hrv`	ms	`nights`
`resting_hr`	bpm	`nights`
`breathing_rate`	breaths/min	`nights`
`skin_temp_deviation`	°C from normal	`nights`
`asleep`	minutes	`nights`
`sleep_need`	minutes	`nights`
`sleep_performance`	% of need	`nights`
`consistency`	Sleep Regularity Index	`nights`
`deep_sleep`	minutes	`nights`
`rem_sleep`	minutes	`nights`
`load`	Load	`days`
`balance`	7-day ÷ 28-day Load	`days`
`steps`	steps	`days`
`stress_day`	score 0–100	`days`
`stress_night`	score 0–100	`days`

Response

{
  "metric": "hrv",
  "unit": "ms",
  "from": "2026-09-25",
  "to": "2026-09-27",
  "points": [
    { "date": "2026-09-25", "value": null },
    { "date": "2026-09-26", "value": 58.4 },
    { "date": "2026-09-27", "value": 70.2 }
  ],
  "stats": { "days_with_data": 2, "mean": 64.3, "min": 58.4, "max": 70.2 },
  "as_of": "2026-09-27T15:20:00Z",
  "methodology": "https://meetkeely.com/methodology"
}

GET /v1/series/{metric}

GET `/v1/series/{metric}`