---
title: "Heart v2 - List"
method: POST
path: "https://wbsapi.withings.net/v2/heart"
tags: ["heart"]
---

# Heart v2 - List

`POST https://wbsapi.withings.net/v2/heart`

## Request

- Base URL: `https://wbsapi.withings.net`
- URL: `https://wbsapi.withings.net/https://wbsapi.withings.net/v2/heart`
- Auth: none declared. Required headers: `Authorization`

Returns a list of ECG records and Afib classification for a given period of time.
To get the full ECG signal, use the [Heart v2 - Get](#operation/heartv2-get) service.

If the ECG recordings have been taken with BPM Core, systole and diastole measurements will also be returned.

## Query parameters

- `action` string, required
- `startdate` integer
- `enddate` integer
- `offset` integer

## Headers

- `Authorization` string, required

## Response `200`

(Click to unfold)

- object
  - `status` integer: Response status. See <a href='#tag/response_status'>Status</a> section for details.
  - `body` object: Response data.
    - `series` HeartMeasurementObject[]
      - `deviceid` string: ID of device that tracked the data. To retrieve information about this device, refer to : <a href='/api-reference/#operation/userv2-getdevice'>User v2 - Getdevice</a>.
      - `model` integer: The source of the recording. | Value | Description| |---|---| |44 | BPM Core| |91 | Move ECG|
      - `ecg` object
        - `signalid` integer: Id of the signal.
        - `afib` integer: Atrial fibrillation classification. | Value | Description| |---|---| |0 | Negative| |1 | Positive| |2 | Inconclusive|
        - `afib_details` integer: Atrial fibrillation details. | Value | Description| |---|---| |-1 | Not processed| |0 | Negative| |1 | Positive| |2 | Inconclusive| |5 | Noise| |6 | Low Heart Rate| |7 | High Heart Rate| |9 | Negative normal HR| |10 | Negative high HR| |11 | Positive normal HR| |12 | Positive high HR| |13 | No Diagnosis calculated|
      - `bloodpressure` object
        - `diastole` integer: Diastole value.
        - `systole` integer: Systole value.
      - `stetho` object
        - `signalid` integer: Id of the signal.
        - `vhd` integer
      - `heart_rate` integer: Average recorded heart rate.
      - `modified` integer: The timestamp of the last modification.
      - `timestamp` integer: Timestamp of the recording.
    - `more` boolean: To know if there is more data to fetch or not.
    - `offset` integer: Offset to use to retrieve the next data.

---

[API](https://skmtc.dev/withings/apis/withings-developer-documentation.md) - [All operations](https://skmtc.dev/withings/apis/withings-developer-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/withings/apis/withings-developer-documentation/revisions/9e9accd01d4b?raw)