---
title: "List Minimal Heartbeats"
method: GET
path: "/v1/heartbeats/minimal"
tags: ["Heartbeats"]
---

# List Minimal Heartbeats

`GET /v1/heartbeats/minimal`

## Request

- Base URL: `https://api.fettle.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fettle.sh/v1/heartbeats/minimal`
- Auth: API key in header `Authorization`

List compact heartbeat rows for selector controls.

## Headers

- `X-Organization-Id` string, uuid, nullable

## Response `200`

Successful Response

- HeartbeatMinimalRead[]
  - `id` string, uuid, required
  - `name` string, required
  - `state` 'PENDING' | 'UP' | 'DOWN' | 'PAUSED', required: Lifecycle state of a heartbeat. ``PENDING`` — created, never pinged; the sweep skips it (``overdue_at`` is NULL) so a freshly created heartbeat does not false-alarm. ``UP`` — pinged within ``period + grace``; the only state the sweep can flip to ``DOWN``. ``DOWN`` — a ping was missed or the job sent ``/fail``; an incident is open. ``PAUSED`` — owner-paused; inactive, never alerts.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fettle/apis/fettle-sh.md) · [All operations](https://skmtc.dev/fettle/apis/fettle-sh/llms.txt) · [OpenAPI document](https://skmtc.dev/fettle/apis/fettle-sh/revisions/f32c8a18606f?raw)