Junction

Junction Time Series API

The Time Series API from Vital — 80 operation(s) for time series.

GitHub OpenAPI
Business capability
Wearable & Health Data Sync AE-130.20

Operations 80

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v2/timeseries/sleep/{sleep_id}/stream Get the sample stream for one sleep session · Get User Sleep Stream #
Ask an LLM
“Can I get second-by-second data like heart rate during a single night's sleep?”
“Where do I fetch the detailed stream behind one sleep record?”
Tell an agent
Get the stream for sleep session {sleep_id}.
Pull the full time series recorded during sleep {sleep_id}.
GET /v2/timeseries/workouts/{workout_id}/stream Get the sample stream for one workout · Get User Workouts #
Ask an LLM
“Can I see the detailed data stream captured during one workout?”
“Is a workout's moment-by-moment data available, not just its totals?”
Tell an agent
Get the stream for workout {workout_id}.
Pull the time series recorded during workout {workout_id}.
GET /v2/timeseries/{user_id}/workout_swimming_stroke/grouped Get swimming stroke counts grouped by source · Workout Swimming Stroke #
Ask an LLM
“Can I pull a swimmer's stroke counts from their workouts?”
“Are swimming stroke samples split out by the device that recorded them?”
Tell an agent
Get {user}'s swimming strokes from {start} to {end}, grouped by source.
Continue listing grouped swim stroke data for {user} from cursor {cursor}.
GET /v2/timeseries/{user_id}/workout_distance/grouped Get workout distance samples grouped by source · Workout Distance #
Ask an LLM
“How far did a user go during workouts over a date range?”
“Can I see workout distance broken down by recording device?”
Tell an agent
Get {user}'s workout distance since {start}, grouped by source.
Page through {user}'s grouped workout distance using cursor {cursor}.
GET /v2/timeseries/{user_id}/heart_rate_recovery_one_minute/grouped Get one-minute heart rate recovery by source · Heart Rate Recovery One Minute #
Ask an LLM
“Can I track how quickly a user's heart rate drops one minute after exercise?”
“Which devices reported one-minute heart rate recovery for a user?”
Tell an agent
Get {user}'s one-minute heart rate recovery from {start} to {end}, grouped by source.
Fetch more grouped heart rate recovery samples for {user} after cursor {cursor}.
GET /v2/timeseries/{user_id}/waist_circumference/grouped Get waist circumference readings by source · Waist Circumference #
Ask an LLM
“Can I pull a user's waist measurements over time?”
“Which app or scale logged a user's waist circumference?”
Tell an agent
Get {user}'s waist circumference since {start}, grouped by source.
Show grouped waist measurements for {user} from {provider}.
GET /v2/timeseries/{user_id}/lean_body_mass/grouped Get lean body mass readings by source · Lean Body Mass #
Ask an LLM
“How has a user's lean body mass changed over a period?”
“Can I see lean mass readings separated by the device that took them?”
Tell an agent
Get {user}'s lean body mass from {start} to {end}, grouped by source.
List lean mass samples per source for {user} from {provider}.
GET /v2/timeseries/{user_id}/body_mass_index/grouped Get BMI readings grouped by source · Body Mass Index #
Ask an LLM
“Can I get a user's BMI history?”
“Which sources reported body mass index values for a user?”
Tell an agent
Get {user}'s BMI readings since {start}, grouped by source.
Page through grouped body mass index data for {user} with cursor {cursor}.
GET /v2/timeseries/{user_id}/basal_body_temperature/grouped Get basal body temperature by source · Basal Body Temperature #
Ask an LLM
“Can I retrieve a user's basal body temperature readings for cycle tracking?”
“What basal temperature data has each source recorded for a user?”
Tell an agent
Get {user}'s basal body temperature from {start} to {end}, grouped by source.
Show basal temperature samples per source for {user} from {provider}.
GET /v2/timeseries/{user_id}/handwashing/grouped Get handwashing events grouped by source · Handwashing #
Ask an LLM
“Can I see how often a user washed their hands, as tracked by their watch?”
“Are handwashing events available per recording source?”
Tell an agent
Get {user}'s handwashing events since {start}, grouped by source.
Fetch the next page of handwashing records for {user} at cursor {cursor}.
GET /v2/timeseries/{user_id}/daylight_exposure/grouped Get daylight exposure time grouped by source · Daylight Exposure #
Ask an LLM
“How much time did a user spend in daylight each day?”
“Can I break down daylight exposure by the device that measured it?”
Tell an agent
Get {user}'s daylight exposure from {start} to {end}, grouped by source.
List time-in-daylight samples per source for {user} from {provider}.
GET /v2/timeseries/{user_id}/uv_exposure/grouped Get UV exposure readings grouped by source · Uv Exposure #
Ask an LLM
“Can I pull a user's ultraviolet exposure levels?”
“Which device recorded a user's UV exposure readings?”
Tell an agent
Get {user}'s UV exposure since {start}, grouped by source.
Page through grouped ultraviolet exposure for {user} with cursor {cursor}.
GET /v2/timeseries/{user_id}/fall/grouped Get detected falls grouped by source · Fall #
Ask an LLM
“Has a user's wearable detected any falls in the last month?”
“Can I list fall events along with the device that detected them?”
Tell an agent
Get fall events for {user} from {start} to {end}, grouped by source.
Show detected falls for {user} reported by {provider}.
GET /v2/timeseries/{user_id}/inhaler_usage/grouped Get inhaler usage events grouped by source · Inhaler Usage #
Ask an LLM
“Can I see how often a user used their inhaler?”
“Which source logged a patient's inhaler puffs?”
Tell an agent
Get {user}'s inhaler usage since {start}, grouped by source.
Fetch more grouped inhaler events for {user} after cursor {cursor}.
GET /v2/timeseries/{user_id}/peak_expiratory_flow_rate/grouped Get peak expiratory flow readings by source · Peak Expiratory Flow Rate #
Ask an LLM
“Can I track a user's peak flow measurements for asthma monitoring?”
“What peak expiratory flow rate values did each source record?”
Tell an agent
Get {user}'s peak expiratory flow rate from {start} to {end}, grouped by source.
List peak flow readings per source for {user} from {provider}.
GET /v2/timeseries/{user_id}/forced_vital_capacity/grouped Get forced vital capacity readings by source · Forced Vital Capacity #
Ask an LLM
“Can I retrieve a user's forced vital capacity lung test results?”
“Which spirometry source reported a user's FVC values?”
Tell an agent
Get {user}'s forced vital capacity since {start}, grouped by source.
Page through grouped FVC readings for {user} using cursor {cursor}.
GET /v2/timeseries/{user_id}/forced_expiratory_volume_1/grouped Get FEV1 readings grouped by source · Forced Expiratory Volume 1 #
Ask an LLM
“Can I pull a user's FEV1, the air exhaled in the first second?”
“Which device recorded forced expiratory volume for a user?”
Tell an agent
Get {user}'s FEV1 values from {start} to {end}, grouped by source.
Show one-second forced expiratory volume per source for {user} from {provider}.
GET /v2/timeseries/{user_id}/wheelchair_push/grouped Get wheelchair push counts grouped by source · Wheelchair Push #
Ask an LLM
“Can I track wheelchair pushes for a wheelchair user?”
“Are wheelchair push counts split out by the device recording them?”
Tell an agent
Get {user}'s wheelchair pushes since {start}, grouped by source.
Fetch the next page of grouped wheelchair push data for {user} at cursor {cursor}.
GET /v2/timeseries/{user_id}/sleep_breathing_disturbance/grouped Get sleep breathing disturbances by source · Sleep Breathing Disturbance #
Ask an LLM
“Can I see breathing disturbances measured during a user's sleep?”
“Which source tracked a user's nighttime breathing disturbances?”
Tell an agent
Get {user}'s sleep breathing disturbances from {start} to {end}, grouped by source.
List breathing disturbance readings during sleep for {user} from {provider}.
GET /v2/timeseries/{user_id}/sleep_apnea_alert/grouped Get sleep apnea alerts grouped by source · Sleep Apnea Alert #
Ask an LLM
“Has a user's watch raised any sleep apnea notifications?”
“Can I list sleep apnea alerts with the source that issued them?”
Tell an agent
Get sleep apnea alerts for {user} since {start}, grouped by source.
Page through grouped apnea alerts for {user} with cursor {cursor}.
GET /v2/timeseries/{user_id}/stand_duration/grouped Get standing time grouped by source · Stand Duration #
Ask an LLM
“How long did a user spend standing each day?”
“Can I see stand duration per recording device?”
Tell an agent
Get {user}'s stand duration from {start} to {end}, grouped by source.
Show time spent standing per source for {user} from {provider}.
GET /v2/timeseries/{user_id}/stand_hour/grouped Get stand hours grouped by source · Stand Hour #
Ask an LLM
“How many hours a day did a user stand up and move?”
“Which sources counted stand hours for a user?”
Tell an agent
Get {user}'s stand hours since {start}, grouped by source.
Fetch more grouped stand hour records for {user} after cursor {cursor}.
GET /v2/timeseries/{user_id}/heart_rate_alert/grouped Get heart rate alerts grouped by source · Heart Rate Alert #
Ask an LLM
“Did a user get any high or irregular heart rate notifications?”
“Can I list heart rate alerts and which device triggered them?”
Tell an agent
Get heart rate alerts for {user} from {start} to {end}, grouped by source.
List heart rate notifications per source for {user} from {provider}.
GET /v2/timeseries/{user_id}/afib_burden/grouped Get AFib burden readings grouped by source · Afib Burden #
Ask an LLM
“Can I track a user's atrial fibrillation burden over time?”
“Which source measured the share of time a user spent in AFib?”
Tell an agent
Get {user}'s AFib burden since {start}, grouped by source.
Page through grouped atrial fibrillation burden for {user} using cursor {cursor}.
GET /v2/timeseries/{user_id}/workout_duration/grouped Get workout durations grouped by source · Workout Duration #
Ask an LLM
“How long were a user's workouts over the past few weeks?”
“Can I see workout time broken down by device?”
Tell an agent
Get {user}'s workout duration from {start} to {end}, grouped by source.
Show exercise duration per source for {user} from {provider}.
GET /v2/timeseries/{user_id}/vo2_max/grouped Get VO2 max estimates grouped by source · Vo2 Max #
Ask an LLM
“Which devices estimated a user's VO2 max, and what did each report?”
“Can I page through VO2 max values separated by source?”
Tell an agent
Get {user}'s VO2 max from {start} to {end}, grouped by source.
Fetch the next page of grouped cardio fitness data for {user} at cursor {cursor}.
GET /v2/timeseries/{user_id}/stress_level/grouped Get stress level readings grouped by source · Stress Level #
Ask an LLM
“Which sources reported a user's stress scores?”
“Can I compare stress levels recorded by different devices for one user?”
Tell an agent
Get {user}'s stress levels since {start}, grouped by source.
List stress readings per device for {user} from {provider}.
GET /v2/timeseries/{user_id}/mindfulness_minutes/grouped Get mindfulness minutes grouped by source · Mindfulness Minutes #
Ask an LLM
“Which apps logged a user's meditation and mindfulness time?”
“Can I see mindful minutes per source for a date range?”
Tell an agent
Get {user}'s mindfulness minutes from {start} to {end}, grouped by source.
Page through grouped meditation minutes for {user} with cursor {cursor}.
GET /v2/timeseries/{user_id}/caffeine/grouped Get caffeine intake grouped by source · Caffeine #
Ask an LLM
“Which apps did a user log caffeine intake in?”
“Can I see caffeine entries split by the app that recorded them?”
Tell an agent
Get {user}'s caffeine intake since {start}, grouped by source.
Show caffeine logs per app for {user} from {provider}.
GET /v2/timeseries/{user_id}/water/grouped Get water intake grouped by source · Water #
Ask an LLM
“Which sources tracked how much water a user drank?”
“Can I get hydration logs separated by app?”
Tell an agent
Get {user}'s water intake from {start} to {end}, grouped by source.
Fetch more grouped hydration entries for {user} after cursor {cursor}.
GET /v2/timeseries/{user_id}/steps/grouped Get step counts grouped by source · Steps #
Ask an LLM
“If a user wears a watch and carries a phone, can I see steps from each separately?”
“Can I page through step samples per recording device?”
Tell an agent
Get {user}'s steps since {start}, grouped by source.
List step counts per device for {user} from {provider} between {start} and {end}.
GET /v2/timeseries/{user_id}/floors_climbed/grouped Get floors climbed grouped by source · Floors Climbed #
Ask an LLM
“Which device counted the floors a user climbed?”
“Can I see stair climbing per source over a date range?”
Tell an agent
Get floors climbed by {user} from {start} to {end}, grouped by source.
Page through grouped stair climbs for {user} with cursor {cursor}.
GET /v2/timeseries/{user_id}/distance/grouped Get distance traveled grouped by source · Distance #
Ask an LLM
“Which sources recorded how far a user walked or ran each day?”
“Can I compare daily distance between a user's devices?”
Tell an agent
Get {user}'s distance traveled since {start}, grouped by source.
Show distance covered per device for {user} from {provider}.
GET /v2/timeseries/{user_id}/calories_basal/grouped Get basal calories grouped by source · Calories Basal #
Ask an LLM
“Which devices estimated a user's resting calorie burn?”
“Can I see basal metabolic calories split by source?”
Tell an agent
Get {user}'s basal calories from {start} to {end}, grouped by source.
Fetch the next page of grouped resting energy for {user} at cursor {cursor}.
GET /v2/timeseries/{user_id}/calories_active/grouped Get active calories grouped by source · Calories Active #
Ask an LLM
“Which sources reported calories a user burned through activity?”
“Can I compare active energy burned across a user's devices?”
Tell an agent
Get {user}'s active calories since {start}, grouped by source.
List active energy burned per device for {user} from {provider}.
GET /v2/timeseries/{user_id}/respiratory_rate/grouped Get respiratory rate grouped by source · Respiratory Rate #
Ask an LLM
“Which devices measured a user's breathing rate?”
“Can I page through respiratory rate samples per source?”
Tell an agent
Get {user}'s respiratory rate from {start} to {end}, grouped by source.
Show breaths-per-minute readings per device for {user} from {provider}.
GET /v2/timeseries/{user_id}/note/grouped Get user notes grouped by source · Note #
Ask an LLM
“Can I pull free-text notes a user logged alongside their health data?”
“Which apps did a user's notes come from?”
Tell an agent
Get notes logged by {user} since {start}, grouped by source.
Fetch more grouped notes for {user} after cursor {cursor}.
GET /v2/timeseries/{user_id}/insulin_injection/grouped Get insulin injections grouped by source · Insulin Injection #
Ask an LLM
“Can I see when a diabetic user logged insulin injections?”
“Which app or pen recorded a user's insulin doses?”
Tell an agent
Get {user}'s insulin injections from {start} to {end}, grouped by source.
List insulin doses per source for {user} from {provider}.
GET /v2/timeseries/{user_id}/ige/grouped Get IgE antibody results grouped by source · Ige #
Ask an LLM
“Which sources reported a user's IgE allergy antibody levels?”
“Can I page through IgE results separated by source?”
Tell an agent
Get {user}'s IgE results since {start}, grouped by source.
Show IgE allergy antibody values per source for {user} from {provider}.
GET /v2/timeseries/{user_id}/igg/grouped Get IgG antibody results grouped by source · Igg #
Ask an LLM
“Which sources reported a user's IgG antibody levels?”
“Can I see IgG food sensitivity results split by source?”
Tell an agent
Get {user}'s IgG results from {start} to {end}, grouped by source.
Fetch the next page of grouped IgG antibody data for {user} at cursor {cursor}.
GET /v2/timeseries/{user_id}/hrv/grouped Get heart rate variability grouped by source · Heart Rate Variability #
Ask an LLM
“Which devices reported a user's HRV?”
“Can I compare heart rate variability between a ring and a watch for one user?”
Tell an agent
Get {user}'s HRV from {start} to {end}, grouped by source.
Page through grouped heart rate variability for {user} using cursor {cursor}.
GET /v2/timeseries/{user_id}/heartrate/grouped Get heart rate samples grouped by source · Heart Rate #
Ask an LLM
“Which sources recorded a user's heart rate throughout the day?”
“Can I page through heart rate readings device by device?”
Tell an agent
Get {user}'s heart rate since {start}, grouped by source.
Show pulse readings per device for {user} from {provider}.
GET /v2/timeseries/{user_id}/glucose/grouped Get glucose readings grouped by source · Glucose #
Ask an LLM
“Which monitors reported a user's blood glucose?”
“Can I see glucose readings separated by the monitor that took them?”
Tell an agent
Get {user}'s glucose from {start} to {end}, grouped by source.
Fetch more grouped blood sugar readings for {user} after cursor {cursor}.
GET /v2/timeseries/{user_id}/cholesterol/grouped Get cholesterol results grouped by source · Cholesterol #
Ask an LLM
“Which sources reported a user's cholesterol results?”
“Can I page through cholesterol values separated by source?”
Tell an agent
Get {user}'s cholesterol since {start}, grouped by source.
List cholesterol results per source for {user} from {provider}.
GET /v2/timeseries/{user_id}/carbohydrates/grouped Get carbohydrate intake grouped by source · Carbohydrates #
Ask an LLM
“Can I see how many carbs a user logged each day?”
“Which nutrition apps recorded a user's carbohydrate intake?”
Tell an agent
Get {user}'s carbohydrate intake from {start} to {end}, grouped by source.
Show carb logs per app for {user} from {provider}.
GET /v2/timeseries/{user_id}/body_temperature_delta/grouped Get body temperature deviation by source · Body Temperature Delta #
Ask an LLM
“Can I see how a user's skin temperature deviated from their baseline?”
“Which device reported nightly temperature changes for a user?”
Tell an agent
Get {user}'s body temperature delta since {start}, grouped by source.
Page through grouped temperature deviation for {user} with cursor {cursor}.
GET /v2/timeseries/{user_id}/body_temperature/grouped Get body temperature readings grouped by source · Body Temperature #
Ask an LLM
“Can I pull a user's measured body temperature over a period?”
“Which thermometer or wearable logged a user's temperature?”
Tell an agent
Pull measured temperature for {user} between {start} and {end}, grouped by source.
List temperature readings per device for {user} from {provider}.
GET /v2/timeseries/{user_id}/body_weight/grouped Get body weight readings grouped by source · Body Weight #
Ask an LLM
“Which scales or apps logged a user's weight?”
“Can I see weigh-ins separated by the device that took them?”
Tell an agent
Get {user}'s body weight since {start}, grouped by source.
Fetch the next page of grouped weigh-ins for {user} at cursor {cursor}.
GET /v2/timeseries/{user_id}/body_fat/grouped Get body fat readings grouped by source · Body Fat #
Ask an LLM
“Which smart scales reported a user's body fat percentage?”
“Can I compare body fat readings across a user's devices?”
Tell an agent
Get {user}'s body fat from {start} to {end}, grouped by source.
Show body fat percentage per source for {user} from {provider}.
GET /v2/timeseries/{user_id}/blood_oxygen/grouped Get blood oxygen readings grouped by source · Blood Oxygen #
Ask an LLM
“Which devices measured a user's SpO2?”
“Can I page through blood oxygen readings device by device?”
Tell an agent
Get {user}'s blood oxygen since {start}, grouped by source.
List oxygen saturation per device for {user} from {provider}.
GET /v2/timeseries/{user_id}/electrocardiogram_voltage/grouped Get ECG voltage samples grouped by source · Electrocardiogram Voltage #
Ask an LLM
“Which devices captured a user's ECG voltage waveforms?”
“Can I page through electrocardiogram voltage samples per source?”
Tell an agent
Get {user}'s ECG voltage from {start} to {end}, grouped by source.
Fetch more grouped electrocardiogram voltage for {user} after cursor {cursor}.
GET /v2/timeseries/{user_id}/blood_pressure/grouped Get blood pressure readings grouped by source · Blood Pressure #
Ask an LLM
“Which cuffs or apps logged a user's blood pressure?”
“Can I separate blood pressure readings by the device that took them?”
Tell an agent
Get {user}'s blood pressure since {start}, grouped by source.
Show systolic and diastolic readings per device for {user} from {provider}.
GET /v2/timeseries/{user_id}/hypnogram/grouped Get sleep stage hypnograms grouped by source · Hypnogram #
Ask an LLM
“Which devices recorded a user's sleep stages through the night?”
“Can I compare hypnograms from two different sleep trackers?”
Tell an agent
Get {user}'s hypnogram since {start}, grouped by source.
List sleep stage timelines per device for {user} from {provider}.
GET /v2/timeseries/{user_id}/vo2_max Get a user's VO2 max as a single series · Vo2 Max #
Ask an LLM
“What is a user's estimated VO2 max over the past few months?”
“Can I chart cardio fitness for a user without splitting by device?”
Tell an agent
Get the VO2 max series for {user} from {start}.
Show {user}'s cardio fitness trend between {start} and {end} from {provider}.
GET /v2/timeseries/{user_id}/stress_level Get a user's stress level series · Stress Level #
Ask an LLM
“How stressed has a user been day to day?”
“Can I get one combined stress score timeline for a user?”
Tell an agent
Get the stress level series for {user} since {start}.
Show {user}'s stress trend from {start} to {end}.
GET /v2/timeseries/{user_id}/mindfulness_minutes Get a user's mindfulness minutes series · Mindfulness Minutes #
Ask an LLM
“How many minutes did a user meditate each day?”
“Can I get a single timeline of mindful minutes for a user?”
Tell an agent
Get the mindfulness minutes series for {user} from {start}.
Show how long {user} meditated between {start} and {end}.
GET /v2/timeseries/{user_id}/caffeine Get a user's caffeine intake series · Caffeine #
Ask an LLM
“How much caffeine has a user logged this week?”
“Can I see total caffeine intake over time for a user?”
Tell an agent
Get the caffeine series for {user} since {start}.
Show {user}'s caffeine consumption from {start} to {end}.
GET /v2/timeseries/{user_id}/water Get a user's water intake series · Water #
Ask an LLM
“How much water did a user drink each day?”
“Can I chart a user's hydration over a date range?”
Tell an agent
Get the water intake series for {user} from {start}.
Show how much {user} drank between {start} and {end}.
GET /v2/timeseries/{user_id}/steps Get a user's step count series · Steps #
Ask an LLM
“How many steps did a user take each day last week?”
“Can I get a user's step counts as one timeline for a date range?”
Tell an agent
Get the step series for {user} since {start}.
Show {user}'s daily steps from {start} to {end} via {provider}.
GET /v2/timeseries/{user_id}/floors_climbed Get a user's floors climbed series · Floors Climbed #
Ask an LLM
“How many flights of stairs did a user climb this month?”
“Can I track floors climbed over time for a user?”
Tell an agent
Get the floors climbed series for {user} from {start}.
Show stairs climbed by {user} between {start} and {end}.
GET /v2/timeseries/{user_id}/distance Get a user's distance traveled series · Distance #
Ask an LLM
“How far did a user walk or run each day?”
“Can I chart total distance over a date range for one user?”
Tell an agent
Get the distance series for {user} since {start}.
Show how far {user} went from {start} to {end}.
GET /v2/timeseries/{user_id}/calories_basal Get a user's basal calorie series · Calories Basal #
Ask an LLM
“What is a user's resting calorie burn over time?”
“Can I get basal metabolic energy as a single timeline?”
Tell an agent
Get the basal calories series for {user} from {start}.
Show {user}'s resting energy burn between {start} and {end}.
GET /v2/timeseries/{user_id}/calories_active Get a user's active calorie series · Calories Active #
Ask an LLM
“How many calories did a user burn through activity each day?”
“Can I chart active energy for a user over a month?”
Tell an agent
Get the active calories series for {user} since {start}.
Show {user}'s active energy burned from {start} to {end}.
GET /v2/timeseries/{user_id}/respiratory_rate Get a user's respiratory rate series · Respiratory Rate #
Ask an LLM
“What has a user's breathing rate been over the last two weeks?”
“Can I track respiratory rate trends for a user?”
Tell an agent
Get the respiratory rate series for {user} from {start}.
Show {user}'s breaths per minute between {start} and {end}.
GET /v2/timeseries/{user_id}/ige Get a user's IgE antibody series · Ige #
Ask an LLM
“What are a user's IgE allergy antibody levels over time?”
“Can I see a user's IgE results as a timeline?”
Tell an agent
Get the IgE series for {user} since {start}.
Show {user}'s IgE allergy test values from {start} to {end}.
GET /v2/timeseries/{user_id}/igg Get a user's IgG antibody series · Igg #
Ask an LLM
“What are a user's IgG antibody levels over time?”
“Can I see a user's IgG results as one timeline?”
Tell an agent
Get the IgG series for {user} from {start}.
Show {user}'s IgG test values between {start} and {end}.
GET /v2/timeseries/{user_id}/hypnogram Get a user's sleep stage hypnogram · Hypnogram #
Ask an LLM
“How much deep, light and REM sleep did a user get each night?”
“Can I get a user's sleep stage timeline without splitting by source?”
Tell an agent
Get the hypnogram for {user} since {start}.
Show {user}'s sleep stages from {start} to {end}.
GET /v2/timeseries/{user_id}/hrv Get a user's heart rate variability series · Heart Rate Variability #
Ask an LLM
“What is a user's HRV trend over the past month?”
“Can I chart heart rate variability as a single series?”
Tell an agent
Get the HRV series for {user} from {start}.
Show {user}'s heart rate variability between {start} and {end} via {provider}.
GET /v2/timeseries/{user_id}/heartrate Get a user's heart rate series · Heart Rate #
Ask an LLM
“What was a user's heart rate during the day yesterday?”
“Can I get a user's heart rate as one continuous timeline?”
Tell an agent
Get the heart rate series for {user} since {start}.
Show {user}'s pulse from {start} to {end}.
GET /v2/timeseries/{user_id}/glucose Get a user's glucose series · Glucose #
Ask an LLM
“What were a user's blood sugar levels over the last day?”
“Can I chart a user's continuous glucose data as one series?”
Tell an agent
Get the glucose series for {user} from {start}.
Show {user}'s blood sugar between {start} and {end} from {provider}.
GET /v2/timeseries/{user_id}/cholesterol/triglycerides Get a user's triglyceride results · Cholesterol/Triglycerides #
Ask an LLM
“What are a user's triglyceride levels over time?”
“Can I see only triglyceride values from a user's lipid results?”
Tell an agent
Get triglycerides for {user} since {start}.
Show {user}'s triglyceride readings from {start} to {end}.
GET /v2/timeseries/{user_id}/cholesterol/total Get a user's total cholesterol results · Cholesterol/Total #
Ask an LLM
“What is a user's total cholesterol trend?”
“Can I pull just total cholesterol, not the LDL or HDL breakdown?”
Tell an agent
Get total cholesterol for {user} from {start}.
Show {user}'s total cholesterol between {start} and {end}.
GET /v2/timeseries/{user_id}/cholesterol/ldl Get a user's LDL cholesterol results · Cholesterol/Ldl #
Ask an LLM
“How has a user's LDL, the bad cholesterol, changed?”
“Can I retrieve only LDL readings for a user?”
Tell an agent
Get LDL cholesterol for {user} since {start}.
Show {user}'s LDL values from {start} to {end}.
GET /v2/timeseries/{user_id}/cholesterol/hdl Get a user's HDL cholesterol results · Cholesterol/Hdl #
Ask an LLM
“How has a user's HDL, the good cholesterol, changed?”
“Can I retrieve only HDL readings for a user?”
Tell an agent
Get HDL cholesterol for {user} from {start}.
Show {user}'s HDL values between {start} and {end}.
GET /v2/timeseries/{user_id}/cholesterol Get a user's combined cholesterol results · Cholesterol #
Ask an LLM
“What do a user's cholesterol results look like across all lipid types?”
“Can I get every cholesterol value for a user in one ungrouped series?”
Tell an agent
Get all cholesterol results for {user} since {start}.
Show {user}'s full lipid readings from {start} to {end} via {provider}.
GET /v2/timeseries/{user_id}/body_weight Get a user's body weight series · Body Weight #
Ask an LLM
“How has a user's weight changed over the last three months?”
“Can I chart weight as a single trend line for a user?”
Tell an agent
Get the body weight series for {user} from {start}.
Show {user}'s weight between {start} and {end}.
GET /v2/timeseries/{user_id}/body_fat Get a user's body fat series · Body Fat #
Ask an LLM
“How has a user's body fat percentage trended?”
“Can I chart body fat for a user over a date range?”
Tell an agent
Get the body fat series for {user} since {start}.
Show {user}'s body fat percentage from {start} to {end}.
GET /v2/timeseries/{user_id}/blood_oxygen Get a user's blood oxygen series · Blood Oxygen #
Ask an LLM
“What were a user's oxygen saturation levels overnight?”
“Can I track SpO2 over time for one user?”
Tell an agent
Get the blood oxygen series for {user} from {start}.
Show {user}'s SpO2 between {start} and {end}.
GET /v2/timeseries/{user_id}/electrocardiogram_voltage Get a user's ECG voltage series · Electrocardiogram Voltage #
Ask an LLM
“Can I get the raw voltage trace from a user's ECG recordings?”
“What ECG voltage data exists for a user in a date range?”
Tell an agent
Get the ECG voltage series for {user} since {start}.
Show {user}'s electrocardiogram waveform from {start} to {end}.
GET /v2/timeseries/{user_id}/blood_pressure Get a user's blood pressure series · Blood Pressure #
Ask an LLM
“What has a user's blood pressure been this month?”
“Can I chart systolic and diastolic readings as one series?”
Tell an agent
Get the blood pressure series for {user} from {start}.
Show {user}'s blood pressure between {start} and {end} via {provider}.

Documentation

📖
Documentation
https://docs.junction.com/api-details/junction-api
📖
Documentation
https://docs.junction.com/wearables/providers/introduction
📖
Documentation
https://docs.junction.com/api-details/junction-management-api

Specifications

⚙
OpenAPI
https://artifacts.apis.io/junction-com/openapi/junction-com-time-series-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-user-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-provider-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-sleep-summary-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-activity-summary-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-heart-rate-timeseries-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-lab-order-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-lab-result-schema.json

Other Resources

🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-create-user-example.json
🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-link-token-example.json
🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-sleep-summary-example.json
🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-heart-rate-timeseries-example.json
🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-create-order-example.json
🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-lab-result-example.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/junction-com:junction-com-time-series-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

junction-com-time-series-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Junction Timeseries API
  version: '1.0'
  description: 'Operations tagged timeseries across 2 of this provider''s published API definitions: junction-openapi-live-2026-10-12.json, vital-openapi-original.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.us.junction.com
  x-fern-server-name: Production
- url: https://api.eu.junction.com
  x-fern-server-name: ProductionEU
- url: https://api.sandbox.us.junction.com
  x-fern-server-name: Sandbox
- url: https://api.sandbox.eu.junction.com
  x-fern-server-name: SandboxEU
security:
- apiKeyAuth: []
tags:


# --- truncated at 32 KB (597 KB total) ---
# Full source: https://artifacts.apis.io/junction-com/openapi/junction-com-time-series-api-openapi.yml