---
title: "Return Apple Healthkit Workout data"
method: GET
path: "/data/v0/{fulcra_userid}/apple_workouts"
tags: ["data"]
---

# Return Apple Healthkit Workout data

`GET /data/v0/{fulcra_userid}/apple_workouts`

## Request

- Base URL: `https://api.fulcradynamics.com`
- URL: `https://api.fulcradynamics.com/data/v0/{fulcra_userid}/apple_workouts`
- Auth: HTTP bearer

Retrieve the Apple workouts that occurred for the user during the specified
period of time.

## Path parameters

- `fulcra_userid` string, uuid, required

## Query parameters

- `start_time` string, date-time, required: The starting timestamp in ISO 8601 format (inclusive)
- `end_time` string, date-time, required: The ending timestamp in ISO 8601 format (exclusive)

## Response `200`

Successful Response

- FulcraAppleWorkout[]
  - `all_statistics` object, required: A collection of descriptive statistics for the workout.
  - `apple_workout_id` string, uuid, required: Workout ID
  - `device` object, nullable, required: Details of the device that recorded the workout,
  - `duration` number, required: Length of the workout (seconds)
  - `end_date` string, date-time, required: the date/time when this workout ends
  - `extras` object, nullable, required: Extra values that are not (yet) accounted for in the schema.
  - `has_undetermined_duration` boolean, required: indicates whether or not this workout has an unknown duration
  - `source_revision` object, required: Details of the source application or device that recorded the workout.
  - `start_date` string, date-time, required: the date/time when this workout starts
  - `workout_activities` object[], required: An ordered list of time segments that describe the workout.
  - `workout_activity_type` string
  - `workout_events` object[], required: An ordered list of events that occurred during the workout.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fulcradynamics/apis/fulcra-life-api.md) · [All operations](https://skmtc.dev/fulcradynamics/apis/fulcra-life-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fulcradynamics/apis/fulcra-life-api/revisions/d85136fc304a?raw)