REST Resource: users.pairedDevices

Resource: PairedDevice

User's Paired 1P Device

The PairedDevice details include information about the device type, battery status, battery level, last sync time, device version, mac address, and features.

JSON representation 
{
  "name": string,
  "deviceType": enum (PairedDevice.DeviceType),
  "batteryStatus": string,
  "batteryLevel": integer,
  "lastSyncTime": string,
  "deviceVersion": string,
  "macAddress": string,
  "features": [
    string
  ]
}
Fields
name

string

Identifier. The resource name of this Device resource.

Format: users/{user}/pairedDevices/{paired_device} Example: users/1234567890/pairedDevices/123 or users/me/pairedDevices/123
deviceType

enum (PairedDevice.DeviceType)

Output only. The device type. Supported: TRACKER | SCALE
batteryStatus

string

Output only. The battery status of the device. Supported: High | Medium | Low | Empty
batteryLevel

integer

Output only. The battery level of the device.
lastSyncTime

string (Timestamp format)

Output only. The time of last sync with the Fitbit mobile application.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
deviceVersion

string

Output only. The product name of the device
macAddress

string

Output only. Mac ID number of the device.
features[]

string

Output only. Lists of unique features supported by the device.

Comprehensive list of supported features:

Fitness Tracking

  • ACTIVE_MINUTES: Legacy active minutes.
  • AUTOSTRIDE: Automatic stride length calculation.
  • BIKE_ONBOARDING: Cycling UI support.
  • CALORIES: Daily burned calories.
  • DISTANCE: Daily distance tracking.
  • ELEVATION: Floors climbed.
  • INACTIVITY_ALERTS: Reminders to move.
  • SEDENTARY_TIME: Tracks inactive time.
  • STEPS: Daily steps.
  • SWIM: Swim tracking (laps/strokes).
  • AUTORUN: Automatic run detection.
  • ACTIVE_ZONE_MINUTES: Active Zone Minutes (AZM).

Heart Rate & Health

  • HEART_RATE: Continuous heart rate (PPG).
  • BAT_SIGNAL: High/Low Heart Rate Alerts.

Advanced Sensors

  • SPO2: Blood oxygen saturation.
  • NIGHTTIME_OXYGEN_SATURATION: Sleep SpO2.
  • ESTIMATED_OXYGEN_VARIATION: Estimated Oxygen Variation.
  • EDA: Electrodermal Activity (stress).
  • SKIN_TEMPERATURE: Skin temperature variation.
  • INTERNAL_DEVICE_TEMPERATURE: Internal device temperature.

Sleep & Wellness

  • SLEEP: Basic sleep tracking.
  • SMART_SLEEP: Advanced sleep tracking (stages/score).
  • BEDTIME_REMINDER: Bedtime reminders.
  • SOUNDSCAPE: Snore and noise detection.

Advanced Workouts

  • WB: Custom Workout Builder.
  • AUTOCUES: Auto Cues / Auto Lap.
  • DWR_RUN: Daily Run Recommendations.
  • ADVANCED_RUNNING: Advanced Running Dynamics (e.g., GCT, VO).

GPS & Location

  • GPS: Built-in GPS.
  • CONNECTED_GPS: Connected GPS (uses phone).
  • LOCATION_HINT: Location helper.

Payments & NFC

  • PAYMENTS: NFC payments (Fitbit Pay/Google Wallet).
  • FELICA: FeliCa support (Japan payments/transit).

Activity Detection

  • GROK: SmartTrack automatic activity detection.
  • RETRO_AR: Retroactive Activity Recognition prompts.

Smart Features & UI

  • ALARMS: Silent alarms.
  • BLE_MUSIC_CONTROL: BLE music control.
  • MUSIC: Direct music storage/control.
  • YOUTUBE_MUSIC_SUPPORTED: YouTube Music support.
  • GALLERY: App Gallery.
  • TUTORIAL_SUPPORTED: On-screen tutorials.
  • SMILEY_EMOTE: Legacy Zip face.
  • MOBILE_TO_DEVICE_DEEPLINK: Mobile to device settings deep link.
  • HIDE_GALLERY: Option to hide Gallery.
  • HIDE_GOAL_SELECTION: Option to hide goal selection.
  • DIGITAL_WARRANTY_SUPPORTED: Digital warranty display.
  • DIRECT_DEVICE_SETTINGS_SUPPORTED: Direct device settings management.

Gym HR Broadcasting

  • ASPEN_SUPPORTED: Broadcast HR to gym equipment.
  • ASPEN_REMOTE_UI_SUPPORTED: Remote UI for HR sharing.

Privacy & Security

  • FINITE_IMPROBABILITY: BLE Resolvable Private Address (RPA) privacy.
  • DOMAIN_KEY_SYNC: Domain key synchronization.

BLE Protocol

  • BONDING: Secure BLE bonding.
  • ADVERTISES_SERIAL: Advertises serial number.
  • STATUS_CHARACTERISTIC: BLE Status Characteristic.
  • TRACKER_CHANNEL_CHARACTERISTIC: BLE Tracker Channel Characteristic.
  • PING_CHARACTERISTIC: BLE Ping Characteristic.

Cellular & Wi-Fi

  • MOBILE_DATA: LTE cellular support.
  • SINGLE_AP_WIFI: Single AP Wi-Fi.
  • MULTI_AP_WIFI: Multi AP Wi-Fi.
  • WIFI_FWUP: Firmware updates over Wi-Fi.

Data Sync & Transfer

  • APP_SYNC: Background app sync.
  • LIVE_DATA: Real-time data streaming.
  • EVENT_BASED_SYNC_SUPPORTED: Event-based sync.
  • TIME_SERVICE: Time synchronization service.
  • REMOTE_FILE_PROVIDER: Remote file transfer.
  • DIRECT_COMMS_ALARMS: Direct communication for alarms.
  • DIRECT_COMMS_EXERCISE: Direct communication for exercise.
  • DIRECT_COMMS_BATTERY_ALERTS: Direct communication for battery alerts.

Google Integrations

  • PARROT_TREE_SUPPORTED: Find My Device support.

PairedDevice.DeviceType

The type of device.

Enums
DEVICE_TYPE_UNSPECIFIED Device type is not specified.
TRACKER Device type is tracker.
SCALE Device type is scale.

Methods

get

 Returns user's Device.

list

 Returns the user's list of paired 1P trackers and smartwatches.