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

# Heart v2 - Get

`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`

Provides the high frequency data of an ECG recording in micro-volt (μV).

**Duration:**

 - BPM Core: 20 seconds.
 - Move ECG: 30 seconds.
 - ScanWatch: 30 seconds.

**Sampling frequency:**

 - BPM Core: 500 Hz.
 - Move ECG: 300 Hz.
 - ScanWatch: 300 Hz.

## Query parameters

- `action` string, required
- `signalid` unknown, required
- `client_id` string, required
- `signature` string, required
- `nonce` string, required
- `signal_token` string, required
- `with_filtered` boolean
- `with_intervals` boolean

## 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.
    - `signal` integer[]: Signal value in micro-volt (μV).
    - `sampling_frequency` integer: Signal Sampling Frequency (Hz).
    - `wearposition` integer: Where the user is wearing the device. | Value | Description| |---|---| |0 | Right Wrist| |1 | Left Wrist| |2 | Right Arm| |3 | Left Arm| |4 | Right Foot| |5 | Left Foot| |6 | Between Legs| |8 | Left part of the body| |9 | Right part of the body| |10 | Left leg| |11 | Right leg| |12 | Torso| |13 | Left hand| |14 | Right hand| |15 | Cardiovascular aortic area| |16 | Cardiovascular pulmonic area| |17 | Cardiovascular tricuspid area| |18 | Cardiovascular mitral area| |19 | Cardiovascular apex area| |20 | Pulmonary front upper right area| |21 | Pulmonary front upper left area| |22 | Pulmonary front bottom right area| |23 | Pulmonary front bottom left area| |24 | Pulmonary back upper left area| |25 | Pulmonary back upper right area| |26 | Pulmonary back bottom left area| |27 | Pulmonary back bottom right area| |28 | Wide mode area| |29 | Between arms| |30 | Hold Right| |31 | Hold Left|
    - `model` integer: The source of the recording. | Value | Description| |---|---| |44 | BPM Core| |91 | Move ECG|
    - `heart_rate` object: Average recorded heart rate.
      - `grpid` integer: Unique identifier of the measure group.
      - `value` integer: Average recorded heart rate.
      - `date` integer: Date at which the measure was taken or entered.
      - `is_deleted` boolean

---

[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)