External: Summaries

Get Body Summary

Changed on

Returns comprehensive body metrics with semantic grouping.

Response is organized into three categories:

  • static: Slow-changing values (weight, height, body fat, muscle mass, BMI, age) Returns the most recent recorded value for each field.
  • averaged: Vitals averaged over a period (resting HR, HRV) Period is configurable via average_period parameter (1-7 days).
  • latest: Point-in-time readings (body temperature, blood pressure) Only returned if measured within latest_window_hours (default 4 hours).

Returns null if no body data exists for the user.

get/api/v1/users/{user_id}/summaries/body

Request

  • Base URL: https://api.openwearables.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.openwearables.io/api/v1/users/{user_id}/summaries/body
  • Auth: OAuth 2 (password, token URL /api/v1/auth/login)

Path parameters

user_idstring uuid required

Query parameters

average_periodinteger

Days to average vitals (1-7)

latest_window_hoursinteger

Hours for latest readings to be considered valid (1-24)

Headers

X-Open-Wearables-API-Keystring nullable

Response

Successful Response

Example response

{
  "source": {
    "provider": "apple",
    "source": "Connect",
    "device": "iPhone15,2",
    "device_id": "R9ZW30ABC12"
  },
  "slow_changing": {
    "weight_kg": 72.5,
    "height_cm": 175.5,
    "body_fat_percent": 18.5,
    "muscle_mass_kg": 58.2,
    "bmi": 23.5,
    "age": 32
  },
  "averaged": {
    "period_days": 7,
    "resting_heart_rate_bpm": 62,
    "avg_hrv_sdnn_ms": 45.2,
    "avg_hrv_rmssd_ms": 42
  },
  "latest": {
    "body_temperature_celsius": 36.6,
    "skin_temperature_celsius": 36.6,
    "blood_pressure": {
      "avg_systolic_mmhg": 120,
      "avg_diastolic_mmhg": 80,
      "max_systolic_mmhg": 135,
      "max_diastolic_mmhg": 90,
      "min_systolic_mmhg": 110,
      "min_diastolic_mmhg": 72,
      "reading_count": 5
    }
  }
}

Changes

  • bc25a1359b11Revision changes
    • info

      added the optional property // to the response with the status

  • 4eaceca2333dRevision changes
    • warning

      added the new bike_computer enum value to the /// response property for the response status

    • warning

      added the new bp_monitor enum value to the /// response property for the response status

    • warning

      added the new chest_strap enum value to the /// response property for the response status

    • warning

      added the new fitness_machine enum value to the /// response property for the response status

    • warning

      added the new glasses enum value to the /// response property for the response status

    • warning

      added the new glucose_meter enum value to the /// response property for the response status

    • warning

      added the new head_mounted enum value to the /// response property for the response status

    • warning

      added the new headphones enum value to the /// response property for the response status

    • warning

      added the new hr_sensor enum value to the /// response property for the response status

    • warning

      added the new sleep_monitor enum value to the /// response property for the response status

    • warning

      added the new smart_display enum value to the /// response property for the response status

    • warning

      added the new tablet enum value to the /// response property for the response status

    • warning

      added the new thermometer enum value to the /// response property for the response status