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

# Measure v2 - Getworkouts

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

Returns workout summaries, which are an aggregation all data that was captured during that workout.

Use the [Measure v2 - Getintradayactivity](#operation/measurev2-getintradayactivity) service to get the high frequency data used to build this summary.

## 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.
    - `series` WorkoutObject[]
      - `id` integer
      - `category` integer: Category of workout: | Value | Description| |---|---| |1 | Walk| |2 | Run| |3 | Hiking| |4 | Skating| |5 | BMX| |6 | Bicycling| |7 | Swimming| |8 | Surfing| |9 | Kitesurfing| |10 | Windsurfing| |11 | Bodyboard| |12 | Tennis| |13 | Table tennis| |14 | Squash| |15 | Badminton| |16 | Lift weights| |17 | Fitness| |18 | Elliptical| |19 | Pilates| |20 | Basket-ball| |21 | Soccer| |22 | Football| |23 | Rugby| |24 | Volley-ball| |25 | Waterpolo| |26 | Horse riding| |27 | Golf| |28 | Yoga| |29 | Dancing| |30 | Boxing| |31 | Fencing| |32 | Wrestling| |33 | Martial arts| |34 | Skiing| |35 | Snowboarding| |36 | Other| |128 | No activity| |187 | Rowing| |188 | Zumba| |191 | Baseball| |192 | Handball| |193 | Hockey| |194 | Ice hockey| |195 | Climbing| |196 | Ice skating| |272 | Multi-sport| |306 | Indoor walk| |307 | Indoor running| |308 | Indoor cycling| |455 | Standup Paddleboarding| |456 | Padel| |457 | Gaming| |490 | Beach volleyball| |491 | Stair Stepper| |492 | Skateboarding| |493 | Parkour| |494 | Kayaking| |495 | Canoeing| |496 | Sailing| |497 | Fishing| |498 | Trail Running| |499 | Snowshoeing| |500 | Paintball| |501 | Archery| |502 | Scuba Diving| |503 | Baseball Training| |504 | Biathlon| |505 | Bocce| |506 | Pétanque| |507 | Paragliding| |508 | Frisbee| |509 | Skydiving| |510 | Pickleball| |511 | Cornhole| |512 | Dodgeball| |513 | Ultimate| |514 | Teqball| |515 | Pushing a Wheelchair (Running Pace)| |516 | Pushing a Wheelchair (Walking Pace)| |517 | Athletics| |518 | Track Cycling| |519 | Pentathlon| |520 | Sport Shooting| |521 | Triathlon| |522 | Diving| |523 | Mountain Biking| |524 | Gravel Biking| |525 | E-Biking| |526 | E-Mountain Biking| |527 | Handcycling| |528 | Velomobile| |529 | Backcountry Skiing| |530 | Nordic Skiing| |531 | Roller Skiing| |532 | Racquetball| |534 | Hip Hop| |535 | Muaythai| |536 | Taekwondo| |537 | Judo| |538 | Trampoline| |539 | Standing Frame| |540 | Seated Strenght| |541 | Seated Cardio| |542 | Walk With Walker| |543 | Walk With Cane| |544 | Breaking| |545 | Chores| |546 | Crossfit| |547 | Spinclass| |548 | Cricket| |549 | Flamenco Dancing| |550 | HIIT| |551 | Meditation| |552 | Stretching| |553 | Yard Work Gardening| |554 | Cleaning| |555 | Public Speaking| |556 | Spikeball| |557 | Lacrosse| |558 | Baby Wearing| |559 | Dog Walking| |560 | Breathing excercises| |561 | Balance Drills| |562 | Pushing a Stroller| |563 | Toddler Wearing| |564 | Bowling| |565 | Lasertag| |566 | Nordic Walking| |567 | Sumo Wrestling| |568 | Cooking| |569 | Match Day| |570 | Jump Rope| |571 | Calisthenics| |572 | Barre| |573 | Aqua Aerobics| |574 | Gymnastics| |575 | Aerobics| |576 | Cheerleading| |577 | Tai Chi| |578 | Qigong| |579 | Sauna| |580 | Cold Plunge| |581 | Karate| |582 | Kickboxing| |583 | Netball| |584 | Softball| |585 | Futsal| |586 | Darts| |587 | Billiards| |588 | Mountaineering| |589 | Bouldering| |590 | Disc Golf| |591 | Wakeboarding| |592 | Water Skiing| |593 | Hunting| |594 | Rucking| |595 | Indoor Rowing| |596 | Resistance Band Training| |597 | Australian Rules Football|
      - `timezone` string: Timezone for the date.
      - `model` integer: Source for the workout. Value can be: | Value | Description| |---|---| |1 | Withings WBS01, type: 1| |2 | Withings WBS03, type: 1| |3 | Kid Scale, type: 1| |4 | Withings WBS02, type: 1| |5 | Body+, type: 1| |6 | Body Cardio, type: 1| |7 | Body, type: 1| |13 | Body+, type: 1| |21 | Smart Baby Monitor, type: 2| |22 | Withings Home, type: 2| |41 | Withings Blood Pressure V1, type: 4| |42 | Withings Blood Pressure V2, type: 4| |43 | Withings Blood Pressure V3, type: 4| |44 | BPM Core, type: 4| |45 | BPM Connect, type: 4| |51 | Pulse, type: 16| |52 | Activite, type: 16| |53 | Activite (Pop, Steel), type: 16| |54 | Withings Go, type: 16| |55 | Activite Steel HR, type: 16| |58 | Pulse HR, type: 16| |59 | Activite Steel HR Sport Edition, type: 16| |60 | Aura dock, type: 32| |61 | Aura sensor, type: 32| |62 | Aura dock, type: 32| |63 | Sleep sensor, type: 32| |70 | Thermo, type: 64| |91 | Move ECG| |92 | Move ECG| |1051 | iOS step tracker, type 16| |1052 | iOS step tracker, type 16| |1053 | Android step tracker, type 16| |1054 | Android step tracker, type 16| |1055 | GoogleFit tracker, type 16| |1056 | Samsung Health tracker, type 16| |1057 | HealthKit step iPhone tracker, type 16| |1058 | HealthKit step Apple Watch tracker, type 16| |1059 | HealthKit other step tracker, type 16| |1060 | Google Health Connect, type 16| |1062 | Huawei tracker, type 16| |1063 | Lingo Sensor, type 1007| |1064 | Health Assistant|
      - `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|
      - `startdate` integer: The starting datetime for workouts data.
      - `enddate` integer: The ending datetime for workouts data.
      - `date` string: Date at which the measure was taken or entered.
      - `modified` integer: The timestamp of the last modification.
      - `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>.
      - `data` object: Details of workout.
        - `algo_pause_duration` integer: *Available for all categories except Multi-sport, Breathing excercises*<br><br>Total pause time in seconds detected by Withings device (swim only)
        - `calories` integer: *Available for all categories except Multi-sport, Breathing excercises*<br><br>Active calories burned (in Kcal). *(Use 'data_fields' to request this data.)*
        - `core_body_temperature_avg` integer: *Available for all categories except Multi-sport, Breathing excercises*<br><br>Average core body temperature (in celsius degrees). *(Use 'data_fields' to request this data.)*
        - `core_body_temperature_max` integer: *Available for all categories except Multi-sport, Breathing excercises*<br><br>Maximal core body temperature (in celsius degrees). *(Use 'data_fields' to request this data.)*
        - `core_body_temperature_min` integer: *Available for all categories except Multi-sport, Breathing excercises*<br><br>Minimal core body temperature (in celsius degrees). *(Use 'data_fields' to request this data.)*
        - `core_body_temperature_status` integer: *Available for all categories except Multi-sport, Breathing excercises*<br><br>Status of the temperature. *(Use 'data_fields' to request this data)* Value can be: 'unknown', 'usual' or 'elevated'. | Value| |---| |unknown| |usual| |elevated|
        - `distance` integer: *Available for all categories except Swimming, Multi-sport, Breathing excercises*<br><br>Distance travelled (in meters). *(Use 'data_fields' to request this data.)*
        - `elevation` integer: *Available for all categories except Swimming, Multi-sport, Breathing excercises*<br><br>Number of floors climbed. *(Use 'data_fields' to request this data.)*
        - `hr_average` integer: *Available for all categories except Multi-sport, Breathing excercises*<br><br>Average heart rate. (beats per minute).*(Use 'data_fields' to request this data.)*
        - `hr_max` integer: *Available for all categories except Multi-sport, Breathing excercises*<br><br>Maximal heart rate (beats per minute).. *(Use 'data_fields' to request this data.)*
        - `hr_min` integer: *Available for all categories except Multi-sport, Breathing excercises*<br><br>Minimal heart rate (beats per minute). *(Use 'data_fields' to request this data.)*
        - `hr_zone_0` integer: *Available for all categories except Multi-sport, Breathing excercises*<br><br>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: *Available for all categories except Multi-sport, Breathing excercises*<br><br>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: *Available for all categories except Multi-sport, Breathing excercises*<br><br>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: *Available for all categories except Multi-sport, Breathing excercises*<br><br>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.)*
        - `intensity` integer: *Available for all categories except Multi-sport, Breathing excercises*<br><br>Intensity of the workout, from 0 to 100, as inputed by the user. If the user didn't manually give the intensity of his workout, the value will be 0.
        - `manual_calories` integer: *Available for all categories except Multi-sport, Breathing excercises*<br><br>Active calories burned manually entered by user (in Kcal). *(Use 'data_fields' to request this data.)*
        - `manual_distance` integer: *Available for all categories except Multi-sport, Breathing excercises*<br><br>Distance travelled manually entered by user (in meters). *(Use 'data_fields' to request this data.)*
        - `manual_intensity` integer: *Available for all categories except Multi-sport, Breathing excercises*<br><br>Intensity of the workout, from 0 to 100, entered by the user. If the user didn't manually give the intensity of his workout, the value will be 0.
        - `pause_duration` integer: *Available for all categories except Multi-sport, Breathing excercises*<br><br>Total pause time in second filled by user
        - `pool_laps` integer: *Available only for Swimming*<br><br>Number of pool laps. *(Use 'data_fields' to request this data.)*
        - `pool_length` integer: *Available only for Swimming*<br><br>Length of the pool. *(Use 'data_fields' to request this data.)*
        - `spo2_average` integer: *Available for all categories except Multi-sport, Breathing excercises*<br><br>Average percent of SpO2 percent value during a workout
        - `steps` integer: *Available for all categories except Swimming, Multi-sport, Breathing excercises*<br><br>Number of steps. *(Use 'data_fields' to request this data.)*
        - `strokes` integer: *Available only for Swimming*<br><br>Number of strokes. *(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)