---
title: "Withings API Integration for Developers"
canonical: "https://help.validic.com/space/VCS/1681326286/Withings%20API%20Integration%20for%20Developers"
format: markdown
---
###### **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](mailto:support@validic.com). For a basic understanding of how to sync a device or app with Validic, please review our “[Marketplace Syncing](http://help.validic.com/customer/en/portal/articles/2877609-marketplace-syncing-process)” overview.
> 📝 The Inform Withings integration uses the Withings EU server, all user data is stored on that server regardless of the user’s location.
**Integration Details**
| Specification | Details |
| --- | --- |
| Source Name | Withings |
| Source | withings |
| App/Portal Languages | English, Spanish, German, French, Japanese, Chinese, Italian, Korean, Russian |
| oAuth Page Languages | English, French, German, Japanese |
| Data Storage Locales | EU (US and global user data is on this server) |
| Supported Resources | Summaries, Workouts, Measurements, Sleep |
| Validated Resources | Dependent upon [Data Origin](https://helpdocs.validic.com/docs/data-origin-validated-data) |
| Sync to Multiple Users | No |
| Workouts Included in Summaries | No |
| oAuth Page Responsive | |
| Age Requirement | Not Specified |
| User Terms of Use/Privacy Policy URL | [https://www.withings.com/us/en/legal/privacy-policy](https://www.withings.com/us/en/legal/privacy-policy) |
| Developer Terms of Use URL | [https://www.withings.com/us/en/legal/api-terms-of-use](https://www.withings.com/us/en/legal/api-terms-of-use) |
**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**
> ℹ️ 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.
See our supported devices page: [https://validic.com/features/supported-devices/?manufacturer=Withings&connections=Cloud](https://validic.com/features/supported-devices/?manufacturer=Withings&connections=Cloud) (already filtered for Withings API)
**Possible Metrics Per Resource**
| Summaries | Workouts | Measurements | Sleep |
| --- | --- | --- | --- |
| active_duration | active_duration | body_weight | light_sleep |
| active_energy_burned | avg_heart_rate | body_height | deep_sleep |
| distance | avg_spo2 | body_fat | rem_sleep |
| elevation | distance | diastolic | awake_count |
| energy_burned | heart_rate_zone_low | systolic | awake_duration |
| fairly_active_duration | heart_rate_zone_medium | pulse | time_to_fall_asleep |
| lightly_active_duration | heart_rate_zone_high | spo2 | sleep_duration |
| steps | heart_rate_zone_very_high | body_temperature | |
| very_active_duration | laps | body_muscle_mass | |
| | max_heart_rate | body_bone_mass | |
| | min_heart_rate | body_lean_mass | |
| | steps | body_fat_mass | |
| | workout_duration | 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 |