---
title: "User v2 - Getgoals"
method: POST
path: "https://wbsapi.withings.net/v2/user     "
tags: ["user"]
---

# User v2 - Getgoals

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

## Request

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

Returns the goals of a user.

## Query parameters

- `action` string, required

## 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.
    - `goals` object
      - `steps` integer: Number of steps per day.
      - `sleep` integer: Sleep duration (seconds).
      - `weight` object: Weight.
        - `value` integer: Value for the measure in S.I. units (kilograms, meters etc...). Value should be multiplied by 10 to the power of ```units``` to get the real value. For ```meastype``` **130** (Atrial fibrillation result), the value is a classification integer and does not represent a physical measurement: | Value | Description | |---|---| |0 | Negative | |1 | Positive | |2 | Inconclusive | |3 | No signal | |4 | Other | |5 | Noise | |6 | Low Heart Rate | |7 | High Heart Rate | |8 | Inconclusive US | |9 | Negative normal HR | |10 | Negative high HR | |11 | Positive normal HR | |12 | Positive high HR | |13 | No Diagnosis |
        - `unit` integer: Power of ten to multiply the ```value``` field to get the real value.<br>Formula: ```value * 10^unit = real value```.<br>Eg: ```value = 20 and unit = -1 => real value = 2```.

---

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