---
title: "Get heartbeats"
method: GET
path: "/api/v1/my/heartbeats"
tags: ["My Data"]
---

# Get heartbeats

`GET /api/v1/my/heartbeats`

Returns a list of heartbeats for the authenticated user within a time range. This is the raw data stream.

## Query parameters

- `start_time` string
- `end_time` string

## Response `200`

successful

## Other responses

- `401` — unauthorized

## Changes

- **2026-01-27** (v1) `b6d6849481da` — 1 breaking, 4 info
  - removed the media type `application/json` for the response with the status `200`
  - the endpoint scheme security `Bearer AND ApiKeyAuth` was added to the API
  - the endpoint scheme security `Bearer` was removed from the API
  - for the `query` request parameter `end_time`, the format was generalized from `date_time` to no format
  - …1 more

[Change history](https://skmtc.dev/hackclub/apis/hackatime-api/changes/api/v1/my/heartbeats/get.md)

---

[API](https://skmtc.dev/hackclub/apis/hackatime-api.md) · [All operations](https://skmtc.dev/hackclub/apis/hackatime-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hackclub/hackatime-api/revisions/b6d6849481da/schema)