Withings API Integration for Developers
- Andrew Rankin
- Toni Connelly
- Matt Dougherty
- Jeff Brown (Unlicensed)
This article pertains to: Inform (v2)
Integration Summary
Validic’s integration with Withings provides support for authenticating and retrieving a Withings user’s fitness, routine, biometrics, sleep, and weight data.
Withings Health Mate is the simple way to take care of yourself and stay healthy. It’s free to download and is designed for anyone who wants to lose a few pounds, exercise more, keep an eye on their blood pressure, or sleep better.
Living healthy starts with knowing where you stand. The Withings app stores history of your data, helps you understand it and improve it over time. You can log this data manually or use one of our many compatible tracking devices and apps to automatically track your health.
Get to the weight that is right for you :
Log your weight data manually or use a Withings Smart scale to do it automatically.
Keep history of your weight and see where you stand on beautiful graphs.
Set yourself achievable goals, and be reminded to focus on your efforts.
Instantly see how close you are to your desired weight.
Stay in shape:
Track your physical activity with the Withings Pulse, or link our free partner app : RunKeeper
Get instant tips and supporting messages from your Withings Health Mate and make sure you achieve the recommended 30 minutes of moderate activity per day.
See how your physical activities impact your weight loss in a snapshot.
Get peace of mind:
Log your blood pressure data.
Be reminded to monitor your heart regularly, and share your data with your doctor and your loved ones.
Consult your Withings health mate and see instantly how well you are taking care of your heart.
Get restful night's sleep:
Sleep does matter and impacts your day to day. Track your sleep automatically by putting your Withings Pulse in the wristband.
Consult your healthy health mate and see instantly if you are getting enough rest.
To request the addition of Withings to your marketplace, please submit a request to support@validic.com. For a basic understanding of how to sync a device or app with Validic, please review our “Marketplace Syncing” overview.
Integration Details
Specification | Details |
|---|---|
Source Name | Nokia |
Source | nokia |
App/Portal Languages | English, Spanish, German, French, Japanese, Chinese, Italian, Korean, Russian |
oAuth Page Languages | English, French, German, Japanese |
Supported Resources | Summaries, Measurments, Sleep |
Validated Resources | Dependent upon Data Origin |
Sync to Multiple Users | No |
Workouts Included in Summaries | No |
oAuth Page Responsive |
|
Age Requirement | Not Specified |
User Terms of Use/Privacy Policy URL | |
Developer Terms of Use URL |
Supported Resource Details
Resource Details for Specified App | Summaries | Workouts | Measurements | Sleep |
|---|---|---|---|---|
Expected Time for New Data to Arrive | ≤ 5 minutes | ≤ 5 minutes | ≤ 5 minutes | ≤ 5 minutes |
Historical Data | 6 months | 6 months | 6 months | 6 months |
Historical Data Completion Time | ≤ 60 minutes | ≤ 60 minutes | ≤ 60 minutes | ≤ 60 minutes |
Timestamp Format | UTC and Offset | UTC and Offset | UTC and Offset | UTC |
Validated | Yes | Yes | Yes | Yes |
Supported Devices
Device | Type | Summaries | Workouts | Measurements | Sleep | FDA Status |
|---|---|---|---|---|---|---|
Nokia Body | Scale | - | - | Supported | - | - |
Nokia Body Cardio | Scale | - | - | Supported | - | - |
Nokia Body+ | Scale | - | - | Supported | - | - |
Nokia Go | Activity Tracker | Supported | Supported | - | Supported | - |
Nokia Steel | Activity Tracker | Supported | Supported | - | Supported | - |
Nokia Thermo | Thermometer | - | - | Supported | - | 510(k) Cleared |
Withings Activite | Activity Tracker | Supported | Supported | - | Supported | - |
Withings Activite Pop | Activity Tracker | Supported | Supported | - | Supported | - |
Withings Activite Steel | Activity Tracker | Supported | Supported | - | Supported | - |
Withings Aura | Sleep Tracker | - | - | - | Supported | - |
Withings Blood Pressure Monitor | Blood Pressure | - | - | Supported | - | 510(k) Cleared |
Withings Body | Scale | - | - | Supported | - | - |
Withings Body Cardio | Scale | - | - | Supported | - | - |
Withings Body+ | Scale | - | - | Supported | - | - |
Withings BPM | Blood Pressure | - | - | Supported | - | 510(k) Cleared |
Withings BPM Connect | Blood Pressure | - | - | Supported | - | 510(k) Cleared |
Withings BPM Core | Blood Pressure | - | - | Supported | - | 510(k) Cleared |
Withings BPM+ | Blood Pressure | - | - | Supported | - | 510(k) Cleared |
Withings Go | Activity Tracker | Supported | Supported | - | Supported | - |
Withings Healthmate App | Activity Tracker | Supported | Supported | Supported | Supported | - |
Withings Move | Activity Tracker | Supported | Supported | Supported | Supported | - |
Withings Move ECG | Activity Tracker | Supported | Supported | Supported | Supported | - |
Withings Pulse | Activity Tracker | Supported | Supported | Supported | Supported | - |
Withings Pulse HR | Activity Tracker | Supported | Supported | Supported | Supported | - |
Withings ScanWatch | Activity Tracker | Supported | Supported | Supported | Supported | - |
Withings Sleep | Sleep Tracker | - | - | - | Sleep | - |
Withings Sleep Analyzer | Sleep Tracker | - | - | - | Sleep | - |
Withings Smart Body Analyzer | Scale | - | - | Supported | - | - |
Withings Steel | Activity Tracker | Supported | Supported | - | Supported | - |
Withings Steel HR | Activity Tracker | Supported | Supported | - | Supported | - |
Withings Steel HR Sport | Activity Tracker | Supported | Supported | - | Supported | - |
Withings Thermo Smart Thermometer | Thermometer | - | - | Supported | - | 510(k) Cleared |
Withings WS-30 Wireless Scale | Scale | - | - | Supported | - | - |
Note: Several Withings devices have also been sold under the Nokia brand. For example, the Withings Body Scale has also been sold as the Nokia Body Scale. The Nokia brand devices also work with the Withings cloud integration.
Possible Metrics Per Resource
Summaries | Workouts | Measurements | Sleep |
|---|---|---|---|
steps | steps | body_weight | light_sleep |
distance | distance | body_height | deep_sleep |
active_energy_burned | active_energy_burned | body_fat | rem_sleep |
energy_burned | laps | diastolic | awake_count |
elevation | workout_duration | systolic | time_to_fall_asleep |
|
| pulse | sleep_duration |
|
| spo2 |
|
|
| body_temperature |
|
|
| body_muscle_mass |
|
|
| body_bone_mass |
|
|
| body_lean_mass |
|
|
| body_fat_mass |
|
|
| body_water_mass |
|
Workout Types and Category Mapping
Vendor Activity Type | Category |
|---|---|
1 | Walk |
2 | Run |
3 | Hiking |
4 | Staking |
5 | BMX |
6 | Bicycling |
7 | Swim |
8 | Surfing |
9 | KiteSurfing |
10 | WindSurfing |
11 | BodyBoard |
12 | Tennis |
13 | Table Tennis |
14 | Squash |
15 | Badminton |
16 | Life Weights |
17 | Calisthenics |
18 | Elliptical |
19 | Pilate |
20 | Basketball |
21 | Soccer |
22 | Football |
23 | Rugy |
24 | VollyBall |
25 | WaterPolo |
26 | HorseRiding |
27 | Golf |
28 | Yoga |
29 | Dancing |
30 | Boxing |
31 | Swim |
32 | Fencing |
33 | Wrestling |
34 | Skiing |
35 | SnowBoarding |
192 | Handball |
If value sent from vendor not in this list | Unknown |