---
title: "Get heart rate timeline for the day"
method: GET
path: "/api/health/heart-rate-timeline"
tags: ["Health"]
---

# Get heart rate timeline for the day

`GET /api/health/heart-rate-timeline`

## Request

- Base URL: `https://api.hiyd.ai`
- URL: `https://api.hiyd.ai/api/health/heart-rate-timeline`
- Auth: HTTP bearer

Returns heart rate data points throughout the day with hourly granularity

## Query parameters

- `date` string, date
- `granularity` 'hourly' | 'week' | 'month' | 'year'
- `time_zone` string

## Response `200`

Heart rate timeline data. Hourly stats carry current, the day's
latest heart-rate reading, and current_at, the ISO-8601 UTC time
of that reading (the phone row's time, or for a tracker reading
its window's midpoint), both null when the day has none. Week,
month and year stats have neither.

---

[API](https://skmtc.dev/hiyd/apis/hiyd-backend-api.md) - [All operations](https://skmtc.dev/hiyd/apis/hiyd-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hiyd/apis/hiyd-backend-api/revisions/23598d347e1b?raw)