---
title: "Heart Rate Alert"
method: GET
path: "/v2/timeseries/{user_id}/heart_rate_alert/grouped"
tags: ["timeseries"]
---

# Heart Rate Alert

`GET /v2/timeseries/{user_id}/heart_rate_alert/grouped`

## Path parameters

- `user_id` string, uuid, required

## Query parameters

- `cursor` string, nullable — The cursor for fetching the next page, or `null` to fetch the first page.
- `next_cursor` string, nullable — The cursor for fetching the next page, or `null` to fetch the first page.
- `provider` string — Provider oura/strava etc
- `start_date` string, required — Date from in YYYY-MM-DD or ISO formatted date time. If a date is provided without a time, the time will be set to 00:00:00
- `end_date` string, nullable — Date to YYYY-MM-DD or ISO formatted date time. If a date is provided without a time, the time will be set to 23:59:59

## Response `200`

Successful Response

- GroupedHeartRateAlertResponse
  - `groups` object, required — For each matching provider or lab, a list of grouped timeseries values.
  - `next` string, nullable — The cursor for fetching the next page, or `null` if there is no more data.
  - `next_cursor` string, nullable — The cursor for fetching the next page, or `null` if there is no more data.

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-22** `366ac8fa8d19` — 3 warning
  - removed the optional property `groups/additionalProperties/items/source/logo` from the response with the `200` status
  - removed the optional property `groups/additionalProperties/items/source/name` from the response with the `200` status
  - removed the optional property `groups/additionalProperties/items/source/slug` from the response with the `200` status

[Change history](https://skmtc.dev/tryvital/apis/junction-api/changes/v2/timeseries/:user_id/heart_rate_alert/grouped/get.md)

---

[API](https://skmtc.dev/tryvital/apis/junction-api.md) · [All operations](https://skmtc.dev/tryvital/apis/junction-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tryvital/apis/junction-api/revisions/55e1b3222cee?raw)