Data Types and Categories

1. Activity-Related Data Types

These track daily activities like sleep, steps, and shopping.

• Sleep
  • Purpose: Tracks how long and how well you sleep.
  • Endpoints: Fetch detailed sleep data or summaries over time.
  • Categories: Includes sleep duration, quality, and patterns (detailed or averaged over intervals like days or weeks).
• Steps
  • Purpose: Counts your daily steps to measure physical activity.
  • Endpoints: Get detailed step counts or averages over time.
  • Categories: Includes total steps taken (detailed or averaged, e.g., per day).
• Shopping Activity
  • Purpose: Records shopping-related activities.
  • Endpoint: Fetch shopping data, either detailed or summarized.
  • Categories: Tracks shopping events (e.g., purchases, time spent).

2. Health-Related Data Types

These monitor physical health metrics.

• Weight
  • Purpose: Measures your body weight and fat percentage.
  • Endpoint: Load weight data.
  • Categories: Includes weight (in pounds or kilograms) and body fat percentage.
• Heart Rate
  • Purpose: Tracks how fast your heart beats.
  • Endpoint: Load heart rate data.
  • Categories: Includes beats per minute (BPM) during activity or rest.
• Resting Heart Rate
  • Purpose: Measures your heart rate when you’re relaxed.
  • Endpoint: Load resting heart rate data.
  • Categories: Includes beats per minute (BPM) at rest.
• Blood Pressure
  • Purpose: Monitors blood pressure levels.
  • Endpoint: Load blood pressure data.
  • Categories: Includes systolic (pressure when heart beats), diastolic (pressure when heart rests), and possibly notes on conditions like normal or high pressure.
• Blood Sugar
  • Purpose: Tracks glucose levels in your blood.
  • Endpoint: Load blood sugar data.
  • Categories: Includes glucose levels (e.g., fasting, after eating) and source (e.g., finger prick).
• Body Temperature
  • Purpose: Measures your body’s temperature.
  • Endpoint: Load temperature data.
  • Categories: Includes temperature readings (e.g., in Celsius or Fahrenheit).
• Pulse Oxygen
  • Purpose: Checks oxygen levels in your blood.
  • Endpoint: Load pulse oxygen data.
  • Categories: Includes oxygen saturation percentage (e.g., SpO2).

3. Event-Related Data Types

These record various personal events, managed through a single endpoint (/v3/event/) for adding, updating, or deleting.

• Blood Glucose
  • Purpose: Logs blood sugar events.
  • Categories: Includes levels like fasting, after meals, or random, plus the sample source (e.g., blood).
• Blood Pressure
  • Purpose: Records blood pressure events.
  • Categories: Includes systolic and diastolic measurements, possibly labeled as normal, high, or low.
• Body Metric
  • Purpose: Tracks general body measurements.
  • Categories: Includes things like height, weight, or body mass index (BMI).
• Audio
  • Purpose: Logs audio-related activities.
  • Categories: Includes audio, song, podcast, audiobook.
• Content
  • Purpose: Tracks content you engage with.
  • Categories: Includes general content, web pages, feeds.
• Image
  • Purpose: Records image-related events.
  • Categories: Includes image, photo, screenshot.
• Interactive
  • Purpose: Logs interactive experiences.
  • Categories: Includes interactive, game, form.
• Text
  • Purpose: Tracks text-based activities.
  • Categories: Includes text, book, blog, article.
• Video
  • Purpose: Records video-related events.
  • Categories: Includes video, movie, TV show, livestream, podcast, music video.
• Exercise
  • Purpose: Logs physical exercise events.
  • Categories: Includes:
    • static_balance
    • dynamic_balance
    • stability
    • daily_activities
    • rehabilitation
    • injury_prevention
    • static_stretching
    • dynamic_stretching
    • joint_mobility
    • muscle_activation
    • self_massage
    • sword_arts
    • basketball
    • volleyball
    • tennis
    • pickleball
    • badminton
    • squash
    • soccer
    • ultimate_frisbee
    • rugby
    • american_football
    • flag_football
    • archery
    • bowling
    • table_tennis
    • golf
    • cricket
    • lacrosse
    • field_hockey
    • handball
    • boxing
    • kickboxing
    • wrestling
    • judo
    • activity_other
    • sport_other
    • exercise
• Cardio
  • Purpose: Tracks cardiovascular exercises.
  • Categories: Includes activities like running, cycling, swimming (exact list not visible in truncated spec).
• Strength
  • Purpose: Records strength training activities.
  • Categories: Includes exercises like weightlifting, resistance, bodyweight (exact list not visible).
• Emotion
  • Purpose: Logs your emotional state.
  • Categories: Includes feelings like happy, sad, angry, calm (exact list not visible).
• Stress
  • Purpose: Tracks stress levels.
  • Categories: Includes levels like low, moderate, high (exact list not visible).
• Core Event
  • Purpose: Records general events.
  • Categories: Includes things like appointments, tasks (exact list not visible).
• Event Group
  • Purpose: Groups multiple events together.
  • Categories: No specific types; used to organize other events.
• Note
  • Purpose: Stores personal notes.
  • Categories: Includes types like personal, reminder, journal (exact list not visible).
• Nutrition
  • Purpose: Tracks food and drink intake.
  • Categories: Includes meal, snack, drink, plus details like calories and nutrients (exact list not visible).
• Symptom
  • Purpose: Logs health symptoms.
  • Categories: Includes issues like headache, fatigue, nausea, tied to body parts (exact list not visible).

4. Environmental Data Types

These monitor surroundings like air, weather, and pollen.

• Air Quality
  • Purpose: Tracks air pollution levels.
  • Endpoints: Get current, forecasted, or location-specific air quality.
  • Categories: Includes measures like PM2.5, air quality index (AQI).
• Weather
  • Purpose: Records weather conditions.
  • Endpoints: Get current, forecasted, or location-specific weather.
  • Categories: Includes temperature, feels-like temperature, wind speed, wind gusts, humidity, cloud cover, UV index, pressure, visibility, precipitation.
• Pollen
  • Purpose: Tracks pollen levels.
  • Endpoints: Get current, forecasted, or location-specific pollen data.
  • Categories: Includes pollen types like tree, grass, weed.

5. Diary and Location Data Types

These log personal events and movements.

• Diary Events
  • Purpose: Records events in your daily life.
  • Endpoints: Fetch detailed or summarized diary entries.
  • Categories: Includes event types like meetings, workouts (exact list not visible).
• Location
  • Purpose: Tracks where you are or have been.
  • Endpoint: Load location data.
  • Categories: Includes coordinates (latitude, longitude), altitude, speed, direction.

6. Miscellaneous Data Types

These cover other tracked items.

• Assets
  • Purpose: Manages files like images or documents.
  • Endpoints: Fetch assets by ID or URL.
  • Categories: Includes file types like photos, recordings (no specific list).
• Plans
  • Purpose: Schedules recurring activities.
  • Categories: Includes details like next scheduled time, streak (e.g., days completed), recurrence pattern.
• Templates
  • Purpose: Reusable event patterns.
  • Categories: Matches event types (e.g., audio, video) for reuse.