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

# Measure v2 - Getactivity

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

## Request

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

Provides daily aggregated activity data of a user.

## Query parameters

- `action` string, required
- `startdateymd` string, required
- `enddateymd` string, required
- `lastupdate` integer, required
- `offset` integer
- `data_fields` string

## 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.
    - `activities` ActivityObject[]
      - `date` string: Date of the aggregated data.
      - `timezone` string: Timezone for the date.
      - `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>.
      - `brand` integer: Specifies if data comes from Withings (device or mobile application tracker) or an external way (Value is 1 for Withings and 18 for external)
      - `is_tracker` boolean: Is true if data was tracked by a Withings tracker (such as Pulse, Go and Watches) otherwise data was tracked by a mobile application or an external way
      - `modified` integer: The timestamp of the last modification.
      - `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|
      - `modelid` 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|
      - `steps` integer: Number of steps. *(Use 'data_fields' to request this data.)*
      - `distance` number: Distance travelled (in meters). *(Use 'data_fields' to request this data.)*
      - `elevation` number: Number of floors climbed. *(Use 'data_fields' to request this data.)*
      - `soft` integer: Duration of soft activities (in seconds). *(Use 'data_fields' to request this data.)*
      - `moderate` integer: Duration of moderate activities (in seconds). *(Use 'data_fields' to request this data.)*
      - `intense` integer: Duration of intense activities (in seconds). *(Use 'data_fields' to request this data.)*
      - `active` integer: Sum of intense and moderate activity durations (in seconds). *(Use 'data_fields' to request this data.)*
      - `calories` number: Active calories burned (in Kcal). Calculated by mixing fine granularity calories estimation, workouts estimated calories and calories manually set by the user. *(Use 'data_fields' to request this data.)*
      - `totalcalories` number: Total calories burned (in Kcal). Obtained by adding active calories (see ```calories```) and passive calories.
      - `hr_average` integer: Average heart rate. (beats per minute).*(Use 'data_fields' to request this data.)*
      - `hr_min` integer: Minimal heart rate (beats per minute). *(Use 'data_fields' to request this data.)*
      - `hr_max` integer: Maximal heart rate (beats per minute).. *(Use 'data_fields' to request this data.)*
      - `hr_zone_0` integer: Duration in seconds when heart rate was in a light zone (cf. <a href='/api-reference/#section/Glossary'>Glossary</a>). *(Use 'data_fields' to request this data.)*
      - `hr_zone_1` integer: Duration in seconds when heart rate was in a moderate zone (cf. <a href='/api-reference/#section/Glossary'>Glossary</a>). *(Use 'data_fields' to request this data.)*
      - `hr_zone_2` integer: Duration in seconds when heart rate was in an intense zone (cf. <a href='/api-reference/#section/Glossary'>Glossary</a>). *(Use 'data_fields' to request this data.)*
      - `hr_zone_3` integer: Duration in seconds when heart rate was in maximal zone (cf. <a href='/api-reference/#section/Glossary'>Glossary</a>). *(Use 'data_fields' to request this data.)*
    - `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)