Terra Docs
Dashboard
  • Docs
  • API Reference
  • Changelog
  • Health & Fitness API
    • REST API Endpoints
    • Supported integrations
    • Event Types
    • Data models
    • Samples
    • Core concepts
    • Destinations
    • Mobile SDK
      • iOS (Swift)
      • Android (Kotlin)
      • React Native
      • Flutter
  • Streaming API
    • REST API Endpoints
    • Supported Integrations
    • Core Concepts
    • Websocket Reference
    • Mobile SDK
      • iOS (Swift)
      • Android (Kotlin)
      • Flutter
      • React Native
  • Teams API - Beta
    • Supported Integrations
    • Core Concepts
    • API Endpoints
    • Event types
Powered by GitBook
On this page
  • MenstruationFlowSample
  • DailyPatternSample (BETA - subject to change)
  • DrinkSample
  • KetoneSample
  • TorqueSample
  • ECGReading
  • GlucoseDataSample
  • HeartRateDataSample
  • LapSample
  • HeartRateVariabilityDataSampleRMSSD
  • HeartRateVariabilityDataSampleSDNN
  • HeartRateZoneData
  • FloorsClimbedSample
  • CalorieSample
  • DistanceSample
  • StepSample
  • ElevationSample
  • PositionSample
  • PowerSample
  • SpeedSample
  • CadenceSample
  • ActivityLevelSample
  • METSample
  • TSSSample
  • SleepHypnogramSample
  • OxygenSaturationSample
  • BreathSample
  • RawECGSample
  • SnoringSample
  • StressSample
  • BodyBatterySample
  • BloodPressureSample
  • MeasurementDataSample
  • TemperatureSample
  • OtherDeviceData
  • HydrationlevelSample
  • HydrationMeasurementSample
  • Vo2MaxSample
  • PulseVelocitySample
  • AFibClassificationSample
  • Meal
  • TagEntry
  • RRInterval

Was this helpful?

  1. Health & Fitness API

Samples

MenstruationFlowSample

{
  "timestamp": String,
  "flow": MenstruationFlow
}

DailyPatternSample (BETA - subject to change)

{
  "time_from_midnight": int,
  "percentile_5": Number,
  "percentile_25": Number,
  "percentile_50": Number,
  "percentile_75": Number,
  "percentile_95": Number
}

DrinkSample

{
  "timestamp": String,                     // required
  "drink_volume": Number,                  // numeric quantity
  "drink_unit": String,                    // e.g. "ml", "fl oz"
  "drink_name": String
}

KetoneSample

{
  "timestamp": String,                     // required
  "ketone_mg_per_dL": Number,              // required
  "sample_type": Number                    // device‑specific enum
}

TorqueSample

{
  "timestamp": String,                     // required – ISO‑8601
  "timer_duration_seconds": Number,
  "torque_newton_meters": Number
}

ECGReading

{
  "start_timestamp": String,
  "avg_hr_bpm": Number,
  "afib_classification": AFibFlag,
  "raw_signal": Array<RawECGSample>
}

GlucoseDataSample

{
  	"timestamp": String,
  	"blood_glucose_mg_per_dL": Number,
    "glucose_level_flag": Number,
    "trend_arrow": Number,
}

HeartRateDataSample

{
  	"timestamp": String,
    "bpm": Number,
  	"timer_duration_seconds": Number,
	  "context": HeartRateContext
}

LapSample

{
  	"start_time": String,
    "end_time": String,
    "distance_meters": Number,
    "calories": Number,
    "total_strokes": Number,
    "stroke_type": StrokeType,
    "avg_speed_meters_per_second": Number
}

HeartRateVariabilityDataSampleRMSSD

{
  	"timestamp": String,
    "hrv_rmssd": Number
}

HeartRateVariabilityDataSampleSDNN

{
  	"timestamp": String,
    "hrv_sdnn": Number
}

HeartRateZoneData

{
  "zone": HeartRateZone,
  "start_percentage": Number,
  "end_percentage": Number,
  "name": String,
  "duration_seconds": Number
}

FloorsClimbedSample

{
  	"timestamp": String,
    "floors_climbed": Number,
    "timer_duration_seconds": Number
}

CalorieSample

{
  	"timestamp": String,
    "calories": Number,
    "timer_duration_seconds": Number
}

DistanceSample

{
  	"timestamp": String,
    "distance_meters": Number,
    "timer_duration_seconds": Number
}

StepSample

{
  	"timestamp": String,
    "steps": Number,
    "timer_duration_seconds": Number
}

ElevationSample

{
  	"timestamp": String,
    "elev_meters": Number,
    "timer_duration_seconds": Number
}

PositionSample

{
  	"timestamp": String,
    "coords_lat_lng_deg": [Number, Number],
    "timer_duration_seconds": Number
}

PowerSample

{
  	"timestamp": String,
    "watts": Number,
    "timer_duration_seconds": Number
}

SpeedSample

{
  	"timestamp": String,
    "speed_meters_per_second": Number,
    "timer_duration_seconds": Number
}

CadenceSample

{
  	"timestamp": String,
    "cadence_rpm": Number,
    "timer_duration_seconds": Number
}

ActivityLevelSample

{
  	"timestamp": String,
    "level": ActivityLevel
}

METSample

{
  	"timestamp": String,
    "level": Number
}

TSSSample

{
  	"planned": Number,
    "actual": Number,
    "method": String,
    "intensity_factor_planned": Number,
    "intensity_factor_actual": Number,
    "normalized_power_watts": Number
}

SleepHypnogramSample

{
  	"timestamp": String,
    "level": SleepLevel
}

OxygenSaturationSample

{
  	"timestamp": String,
    "percentage": Number
}

BreathSample

{
  	"timestamp": String,
    "breaths_per_min": Number
}

RawECGSample

{
  "potential_uV": Number,
  "timestamp: String
}

SnoringSample

{
  	"timestamp": String,
    "duration_seconds": Number
}

StressSample

{
  	"timestamp": String,
    "level": Number
}

BodyBatterySample

{
  	"timestamp": String,
    "level": Number
}

BloodPressureSample

{
  	"timestamp": String,
    "diastolic_bp": Number,
    "systolic_bp": Number
}

MeasurementDataSample

{
  	"measurement_time": String,
    "BMI": Number,
    "BMR": Number,
    "RMR": Number,
    "estimated_fitness_age": Number,
    "skin_fold_mm": Number,
    "bodyfat_percentage": Number,
    "weight_kg": Number,
    "height_cm": Number,
    "bone_mass_g": Number,
    "muscle_mass_g": Number,
    "lean_mass_g": Number,
    "water_percentage": Number,
    "insulin_units": Number,
    "insulin_type": String,
    "urine_color": String,
  	"user_notes": String
}

TemperatureSample

{
  	"timestamp": String,
    "temperature_celsius": Number
}

OtherDeviceData

{
  	"name": String,
    "manufacturer": String,
    "serial_number": String,
    "software_version": String,
    "hardware_version": String,
	  "last_upload_date": String,
		"data_provided": Array<DeviceDataType>
}

HydrationlevelSample

{
  	"timestamp": String,
    "hydration_level": Number
}

HydrationMeasurementSample

{
  	"timestamp": String,
    "hydration_kg": Number
}

Vo2MaxSample

{
  	"timestamp": String,
    "vo2max_ml_per_min_per_kg": Number
}

PulseVelocitySample

{
  	"timestamp": String,
    "pulse_wave_velocity_meters_per_second": Number
}

AFibClassificationSample

{
  	"timestamp": String,
    "afib_classification": AfibFlag
}

Meal

{
  	"name": String,
    "id": String,
    "timestamp": String,
    "type": Number,
    "quantity": {
      	"unit": NutritionUnits,
        "amount": Number
    },
    "macros": {
        "calories": Number,
        "protein_g": Number,
        "carbohydrates_g": Number,
        "fat_g": Number,
        "sugar_g": Number,
        "cholesterol_mg": Number,
        "fiber_g": Number,
        "sodium_mg": Number,
        "alcohol_g": Number
    },
    "micros": {
        "selenium_mg": Number,
        "niacin_mg": Number,
        "magnesium_mg": Number,
        "copper_mg": Number,
        "vitamin_B12_mg": Number,
        "vitamin_B6_mg": Number,
        "vitamin_C_mg": Number,
        "zinc_mg": Number,
        "vitamin_E_mg": Number,
        "manganese_mg": Number,
        "vitamin_D_mg": Number,
        "iodine_mg": Number,
        "chloride_mg": Number,
        "folate_mg": Number,
        "calcium_mg": Number,
        "molybdenum_mg": Number,
        "vitamin_A_mg": Number,
        "riboflavin_mg": Number,
        "folic_acid_mg": Number,
        "iron_mg": Number,
        "thiamin_mg": Number,
        "pantothenic_acid_mg": Number,
        "caffeine_mg": Number,
        "vitamin_K_mg": Number,
        "chromium_mg": Number,
        "potassium_mg": Number,
        "biotin_mg": Number,
        "phosphorus_mg": Number
    }
}

TagEntry

{
  "timestamp": String,
  "tag_name": String,
  "notes": String
}

RRInterval

{
  "timestamp": String,
  "rr_interval_ms": Number,
  "hr_bpm": Number
}
PreviousData modelsNextCore concepts

Last updated 21 days ago

Was this helpful?