users

GET /v4/users/{usersId}/pairedDevices/{pairedDevicesId}

Returns user's Device.

Request

  • Base URL
    https://health.googleapis.com
  • URL
    https://health.googleapis.com/v4/users/{usersId}/pairedDevices/{pairedDevicesId}
  • Auth
    OAuth 2 and OAuth 2
    Implicit: https://accounts.google.com/o/oauth2/auth
    Scopes: https://www.googleapis.com/auth/googlehealth.settings.readonly
    Authorization code: https://accounts.google.com/o/oauth2/auth
    Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/googlehealth.settings.readonly

Path parameters

usersIdstring required
pairedDevicesIdstring required

Response

Successful response

batteryLevelinteger

Output only. The battery level of the device.

batteryStatusstring

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

deviceType'DEVICE_TYPE_UNSPECIFIED' | 'TRACKER' | 'SCALE'

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

deviceVersionstring

Output only. The product name of the device

featuresstring[]

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.

lastSyncTimestring google-datetime

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

macAddressstring

Output only. Mac ID number of the device.

namestring

Identifier. The resource name of this Device resource. Format: users/{user}/pairedDevices/{paired_device} Example: users/1234567890/pairedDevices/123 or users/me/pairedDevices/123

Changes

No recorded changes to this operation across all 6 revisions of this API.