Fitbit API Integration for Developers

This article pertains to: Inform (v2)

 

Validic is pleased to announce we are expanding the Validic marketplace with the addition of Fitbit. Validic’s integration with Fitbit provides support for authenticating and retrieving a Fitbit user’s fitness, routine, nutrition sleep, and weight data.

The Fitbit family motivates you to stay active, live better and reach your goals. Let's make fitness a fun, achievable part of everyday life. Our products track your health and fitness, then sync wirelessly to offer insight and encouragement whether you're online or on the go. So get ready to go farther.

To request the addition of Fitbit 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

Specification

Details

Source Name

Fitbit

Source

fitbit

App/Portal Languages

English, French, German, Spanish, Japanese

oAuth Page Languages

English, French, German, Spanish, Japanese

Supported Resources

Summaries, Workouts, Nutrition, Measurements, Sleep

Validated Resources

Dependent upon Data Origin

Sync to Multiple Users

No

Workouts Included in Summaries

Yes

oAuth Page Responsive

Yes

Age Requirement

13+

User Terms of Use/Privacy Policy URL

http://www.fitbit.com/terms

Developer Terms of Use URL

https://dev.fitbit.com/legal/fitbit-user-data-and-developer-policy/

 

Supported Resource Details   

Resource Details

Summaries

Workouts

Nutrition

Weight

Sleep

Intraday

Resource Details

Summaries

Workouts

Nutrition

Weight

Sleep

Intraday

Expected Time for New Data to Arrive

≤ 2 minutes

≤ 2 minutes

≤ 2 minutes

≤ 2 minutes

≤ 2 minutes

≤ 60 minutes

Historical Data

6 months

6 months

6 months

24 months

6 months

7 days

Historical Data Completion Time

≤ 24 hours

almost 10 hours

almost 10 hours

almost 10 hours

almost 10 hours

≤ 24 hours

Timestamp Format

UTC and Offset

UTC and Offset

UTC and Offset w/o Time

UTC and Offset (w/o Time for Manual Entries)

UTC and Offset w/o Time

UTC and Offset

Validated

Customer determined based on value of "origin" field in "metric"

Customer determined based on value of "origin" field in "metric"

No

Customer determined based on value of "origin" field in "metric"

No

Customer determined based on value of "origin" field in "metric"

 

Supported Devices 

Device

Type

Summaries

Workouts

Measurements

Sleep

Nutrition

Device

Type

Summaries

Workouts

Measurements

Sleep

Nutrition

Fitbit App

Activity Tracker

Supported

Supported

Supported

Supported

Supported

Fitbit Aria

Scale

-

-

Supported

-

-

Fitbit Aria 2

Scale

-

-

Supported

-

-

Fitbit Aria Air

Scale

-

-

Supported

-

-

Fitbit Flex

Activity Tracker

Supported

-

-

Supported

-

Fitbit Charge

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Charge HR

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Charge 2

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Charge 3

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Charge 4

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Charge 4 Special Edition

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Charge 5

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Force

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit One

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Surge

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Ultra

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Zip

Activity Tracker

Supported

 

-

 

-

Fitbit Blaze

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Alta

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Flex 2

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Alta HR

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Ionic

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Versa

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Versa 2

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Versa Special Edition

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Versa Lite

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Versa 3

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Inspire HR

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Inspire

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Inspire 2

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Sense

Activity Tracker

Supported

Supported

-

Supported

-

Fitbit Luxe

Activity Tracker

Supported

Supported

-

Supported

-

 

Possible Metrics Per Resource 

Summaries

Workouts

Nutrition

Measurements

Sleep

Intraday

Summaries

Workouts

Nutrition

Measurements

Sleep

Intraday

active_duration

steps

energy_consumed

bmi

awake_count

steps

active_energy_burned

energy_burned

carbohydrate

body_weight

sleep_duration

distance

basal_energy_burned

distance

dietary_fiber

body_fat

awake_duration

avg_heart_rate

distance

duration

protein

 

time_to_fall_asleep

elevation

elevation

avg_heart_rate

fat

 

 awake_duration

avg_spo2

floors_climbed

active_duration

sodium

 

 restless_count

 

steps

heart_rate_zone_very_low

water

 

in_bed_duration

 

energy_burned

heart_rate_zone_low

 

 

rem_sleep

 

heart_rate_zone_very_low

heart_rate_zone_medium

 

 

deep_sleep

 

heart_rate_zone_low

heart_rate_zone_high

 

 

light_sleep

 

heart_rate_zone_medium

 workout_duration

 

 

 

 

heart_rate_zone_high

 

 

 

 

 

resting_heart_rate

 

 

 

 

 

avg_spo2

 

 

 

 

 

max_spo2

 

 

 

 

 

min_spo2

 

 

 

 

 

respiratory_rate

 

 

 

 

 

body_temperature_deviation

 

 

 

 

 

heart_rate_variability

 

 

 

 

 

 

Workout Types and Category Mapping

Vendor Activity Type

Activity Category

Vendor Activity Type

Activity Category

Aerobics

Cardio

Archery

Cardio

Badminton

Cardio

Ballet

Other

Barre Class

Other

Baseball

Cardio

Basketball

Cardio

Belly dancing

Other

Bicycling

Biking

Bike

Biking

bike riding

Biking

biking

Biking

Boot Camp

Cardio

Boxing

Cardio

Calisthenics

Cardio

Canoeing

Cardio

Cardio kickboxing

Cardio

Cardio Sculpt

Cardio

Carpentry

Other

Circuit training

Other

Cleaning

Other

Cricket

Cardio

Cross Country Skiing

Cardio

Crossfit

Other

Curling

Cardio

cycling

Biking

Dancing

Other

Diving

Swimming

Driving

Other

Elliptical

Cardio

Elliptical Trainer

Cardio

Fencing

Cardio

Field Hockey

Cardio

Fishing

Other

Football

Cardio

Gardening

Other

Golf

Cardio

Gymnastics

Cardio

Handball

Cardio

Hike

Walking

Hockey

Cardio

Horseback riding

Other

Horseback riding

Cardio

Hunting

Other

Ice Skating

Cardio

jog

Running

jogging

Running

Jumping rope

Cardio

Kayaking

Cardio

Kettlebell

Strength

Kickboxing

Cardio

Lacrosse

Cardio

Martial arts

Cardio

Meditating

Other

Motorcycle

Other

Mountain Bike

Biking

Mowing lawn

Other

Orienteering

Walking

Pilates

Other

Racquetball

Cardio

Rock climbing

Cardio

Roller blading

Cardio

Roller skating

Cardio

Rowing

Cardio

Rowing machine

Cardio

Rugby

Cardio

Run

Running

Running

Running

Sailing

Cardio

Scuba Diving

Swimming

Shooting

Other

Skateboarding

Other

Skiing

Cardio

Snorkeling

Swimming

Snowshoeing

Cardio

Soccer

Cardio

Softball

Cardio

Spinning

Biking

Squash

Cardio

Stairclimber

Walking

Stretching

Other

Swimming

Swimming

Swimming laps

Swimming

Tabata Workout

Cardio

Table tennis

Cardio

Tai Chi

Other

Tennis

Cardio

Trampoline

Other

Treadmill

Walking

TRX

Strength

Ultimate frisbee

Cardio

Volleyball

Cardio

Walking

Walking

Water aerobics

Cardio

Water jogging

Swimming

Water polo

Cardio

Water volleyball

Cardio

Weights

Strength

Wrestling

Cardio

Yoga

Other

Zumba

Cardio