Fitbit Schema Reference
Stay organized with collections
Save and categorize content based on your preferences.
Exported Object: Fitbit device events Exported Object represents: List of your Fitbit Device events data.This information can reveal detailed patterns about how you interact with your device. Object is exported in these formats: JSON
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *
Field Definition
Data Field Type
BatteryMonitorEvents
Events logged by the battery monitoring system on your Fitbit device. Each entry represents one of the following specific events: error, bat_temperature_event
json
ButtonEvents
Events logged from button presses on your Fitbit device. Each entry represents the following: event, gain, event_count
json
ChargerEvents
Events logged by the charging system on your Fitbit device. Each entry is a JSON object that includes a mandatory event field and exactly one of the following: charger_state, bq25120_state, max14676_state, charge_cycles, bq25150_state, regdump, bq25120_state_fault, battery_charge_dcr, vbus_short_detection, battery_accounting, bq25190_state
json
EcgAppEvents
Events logged by the ECG app on your Fitbit device. Each entry is a JSON object that includes a mandatory func_addr and line_no fields and exactly one of the following: error, view_changed, button_pressed, analyze_result, duration, deleted_result, heap_info
json
PwrStatsEvents
Events logged by the power monitoring system on your Fitbit device. Each entry is a JSON object that includes a mandatory no_of_events, duration_ms, and app_name fields and exactly one of the following: mcu, display, ui, fwup, touch, btn, wrist, ble, hrm, vibe, flash, clock_face, fs, gnss, aod, charger, gestures
json
StateOfChargeEvents
Events logged by the state of the charging system on your Fitbit device. Each entry is a JSON object that includes the following fields: type, voltage, percentage, percentage_rt, power_good, is_charging, debug_state, battery_temperature
json
TemperatureEvents
Events logged by the temperature system on your Fitbit device. Each entry is a JSON object that includes one of the following fields: temperature_reading, temperature_histogram, temperature_monitor_mode
json
TouchEvents
Events logged by the touch system on your Fitbit device. Each entry is a JSON object that includes one of the following fields: touch_transition, touch_error, touch_nv, touch_nv_done, touch_lib_error, touch_lib_warning, touch_auto_calibration
json
UIEvents
Events logged by the UI system on your Fitbit device. Each entry is a JSON object that includes one of the following fields: auto_wake, button_lock_toggle, hr_notifications, stress_tile, oobe, tiles_config, popup_hfp, gmaps_app, aspen_config, music_app, exapp_settings, exapp_session, auto_detect, hr_zones_set, data_provider, ar_settings, fbui_status
json
A table representing Resource Groups and the objects that are exported with it.
Resource Group *
Description
Exported Objects
fitbit.device_events
This resource group contains device events data (such as TouchEvents, BatteryMonitorEvents) collected from Fitbit devices.
Fitbit device events
* To obtain the OAuth Scope Name for a particular Resource Group, append "https://www.googleapis.com/auth/dataportability." to the Resource Group. For example, the OAuth Scope Name for the "myactivity.search" Resource Group is "https://www.googleapis.com/auth/dataportability.myactivity.search".
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-04-20 UTC."],[],[]]