---
title: "Measure - Getmeas"
method: POST
path: "https://wbsapi.withings.net/measure"
tags: ["measure"]
---

# Measure - Getmeas

`POST https://wbsapi.withings.net/measure`

## Request

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

Provides measures stored at a specific date among the types below. Please refer to the following responses for details.

## Query parameters

- `action` string, required
- `signature` string
- `meastype` integer
- `meastypes` unknown
- `category` integer
- `startdate` integer
- `enddate` integer
- `lastupdate` 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.
    - `updatetime` string: Server time at which the answer was generated.
    - `timezone` string: Timezone for the date.
    - `measuregrps` MeasuregrpObject[]: For every measure/measurement made, a measure group is created. The measure group purpose is to group together measures that have been taken at the same time. For instance, when measuring blood pressure you will have a measure group with a systole measure, a diastole measure, and a heartrate measure. Every time a measure is create/updated/deleted, the corresponding measure group is updated.
      - `grpid` integer: Unique identifier of the measure group.
      - `attrib` integer: The way the measure was attributed to the user: | Value | Description| |---|---| |0 | The measuregroup has been captured by a device and is known to belong to this user (and is not ambiguous)| |1 | The measuregroup has been captured by a device but may belong to other users as well as this one (it is ambiguous)| |2 | The measuregroup has been entered manually for this particular user| |4 | The measuregroup has been entered manually during user creation (and may not be accurate)| |5 | Measure auto, it's only for the Blood Pressure Monitor. This device can make many measures and computed the best value| |7 | Measure confirmed. You can get this value if the user confirmed a detected activity| |8 | Same as attrib 0| |15 | The measure has been performed in specific guided conditions. Apply to Nerve Health Score|
      - `date` integer: UNIX timestamp when measures were taken.
      - `created` integer: UNIX timestamp when measures were stored.
      - `modified` integer: UNIX timestamp when measures were last updated.
      - `category` integer: Category for the measures in the group (see category input parameter).
      - `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>.
      - `hash_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>.
      - `measures` MeasureObject[]: List of measures in the group.
        - `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 |
        - `type` integer: Type of the measure. See ```meastype``` input parameter.
        - `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```.
        - `algo` integer: Deprecated.
        - `fm` integer: Deprecated.
        - `position` integer: The device's position during the measure. | 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` string: Device model. Value can be: | Value | Description| |---|---| |Withings WBS01 | Scale| |WS30 | Scale| |Kid Scale | Scale| |Smart Body Analyzer | Scale| |Body+ | Scale| |Body Cardio | Scale| |Body | Scale| |Body Scan | Scale| |Body Pro | Scale| |WBS10 | Scale| |WBS11 | Scale| |Body Comp | Scale| |Smart Baby Monitor | Babyphone| |Withings Home | Babyphone| |Withings Blood Pressure Monitor V1 | Blood Pressure Monitor| |Withings Blood Pressure Monitor V2 | Blood Pressure Monitor| |Withings Blood Pressure Monitor V3 | Blood Pressure Monitor| |BPM Core | Blood Pressure Monitor| |BPM Connect | Blood Pressure Monitor| |BPM Connect Pro | Blood Pressure Monitor| |BPM Pro 2 | Blood Pressure Monitor| |BPM Vision | Blood Pressure Monitor| |Pulse | Activity Tracker| |Activite | Activity Tracker| |Activite (Pop, Steel) | Activity Tracker| |Withings Go | Activity Tracker| |Activite Steel HR | Activity Tracker| |Activite Steel HR Sport Edition | Activity Tracker| |Pulse HR | Activity Tracker| |Move | Activity Tracker| |Move ECG | Activity Tracker| |ScanWatch | Activity Tracker| |ScanWatch 2 | Activity Tracker| |ScanWatch Light | Activity Tracker| |Aura Dock | Sleep Monitor| |Aura Sensor | Sleep Monitor| |Aura Sensor V2 | Sleep Monitor| |Thermo | Smart Connected Thermometer| |BeamO | Smart Connected Thermometer| |WUP01 | Gateway| |iGlucose Plus | Smart Meter| |iGlucose Essential | Smart Meter| |iPulse OX | Smart Meter| |iOS step tracker | HealthKit Apple| |HealthKit step iPhone tracker | HealthKit Apple| |HealthKit step Apple Watch tracker | HealthKit Apple| |HealthKit other step tracker | HealthKit Apple| |Android step tracker | HealthKit Google| |GoogleFit tracker | HealthKit Google| |Samsung Health tracker | HealthKit Google| |Google Health Connect | HealthKit Google| |Huawei tracker | HealthKit Huawei| |Lingo Sensor | Lingo| |WPA02 | Fluid Analyzer|
      - `model_id` integer: | Value | Description| |---|---| |1 | Withings WBS01| |2 | WS30| |3 | Kid Scale| |4 | Smart Body Analyzer| |5 | Body+| |6 | Body Cardio| |7 | Body| |10 | Body Scan| |9 | Body Pro| |11 | WBS10| |12 | WBS11| |18 | Body Comp| |21 | Smart Baby Monitor| |22 | Withings Home| |41 | Withings Blood Pressure Monitor V1| |42 | Withings Blood Pressure Monitor V2| |43 | Withings Blood Pressure Monitor V3| |44 | BPM Core| |45 | BPM Connect| |46 | BPM Connect Pro| |47 | BPM Pro 2| |48 | BPM Vision| |51 | Pulse| |52 | Activite| |53 | Activite (Pop, Steel)| |54 | Withings Go| |55 | Activite Steel HR| |59 | Activite Steel HR Sport Edition| |58 | Pulse HR| |90 | Move| |91 | Move ECG| |92 | Move ECG| |93 | ScanWatch| |94 | ScanWatch 2| |95 | ScanWatch Light| |60 | Aura Dock| |61 | Aura Sensor| |63 | Aura Sensor V2| |70 | Thermo| |71 | BeamO| |100 | WUP01| |1061 | iGlucose Plus| |1065 | iGlucose Essential| |1066 | iPulse OX| |1051 | iOS step tracker| |1052 | iOS step tracker| |1057 | HealthKit step iPhone tracker| |1058 | HealthKit step Apple Watch tracker| |1059 | HealthKit other step tracker| |1053 | Android step tracker| |1054 | Android step tracker| |1055 | GoogleFit tracker| |1056 | Samsung Health tracker| |1060 | Google Health Connect| |1062 | Huawei tracker| |1063 | Lingo Sensor| |102 | WPA02|
      - `comment` string: Deprecated. This property will always be empty.
    - `more` integer: 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)