Fitness
- Selma Pittman
GET: https://api.validic.com/v1/organizations/{organization_id}/users/{user_id}/fitness.json
Fitness records return data for activities undertaken with the express purpose of exercising. These activities have a defined duration (time, distance, elevation, etc.)
Fitness URLS
GET /v1/organizations/:organization_id/fitness
GET /v1/organizations/:organization_id/fitness/latest
GET /v1/organizations/:organization_id/users/:user_id/fitness
GET /v1/organizations/:organization_id/users/:user_id/fitness/latest
Fitness Short URLS
GET /v1/fitness/latest(.:format)
GET /v1/fitness(.:format)
Parameters
The following section displays the parameters used to retrieve data.
Return Values
The following values are included in a standard response. Expanded data varies by source. You can locate a complete list of expanded fields here.
Return Value | Type | Description |
|---|---|---|
timestamp | String | Timestamp for the measurement set |
utc_offset | String | Timezone information for the measurement set |
type | String | Sample types of activities: Running, Cycling, Mountain Biking, Walking, Hiking, Downhill Skiing, Cross-country Skiing, Snowboarding, Skating, Swimming, Rowing, Elliptical, Other. Activities vary from source to source and are returned as provided by source. Read more here. |
intensity | String | Subjective intensity with which an activity was performed. Examples are: low, medium, high. Returned as provided by source. |
start_time | String | Starting time for the activity. Preferred format is an ISO 8601 timestamp (YYYY-MM-DDThh:mm:ssZ, e.g., 2013-03-10T07:12:16-05:00). |
distance | Double | The value of the measured quantity in meters |
duration | Double | The value of the measured quantity in seconds |
calories | Double | The value of the measured quantity in kilocalories (Calories) |
source | String | The short name of the application that recorded the activity |
source_name | String | The display name of the application that recorded the activity |
last_updated | String | Date and time when the measurement set was last updated |
_id | String | Unique identifier of the activity (required for POST requests) |
validated | Boolean | Value indicates the data you are receiving was generated using a device, opposed to being manually entered by an end user |
activity_category | String | "activity_category" displays type of activity, such as Aerobic Training, Weight Training, Circuit Training, Walking, Bicycling, Running, Elliptical, Swimming, Yoga and Pilates, Sports, Winter Activities, House Work, Yard Work, Miscellaneous, or unknown. Unlike "type" which may be unpredictable, "activity_category" provides a standardized activity type. Read more here. |
Additional Examples
Filter by date and expanded
GET https://api.validic.com/v1/organizations/{ORGANIZATION_ID}/users/{USER_ID}/fitness.json?access_token={ORGANIZATION_ACCESS_TOKEN}&start_date=2015-09-01T00:00:00+00:00&end_date=2015-09-30T23:59:59+00:00&expanded=1
Filter by Source
GET https://api.validic.com/v1/fitness.json?authentication_token={USER_ACCESS_TOKEN}&source={SOURCE}
Start Date of Activity
GET https://api.validic.com/v1/organizations/{ORGANIZATION_ID}/fitness.json?access_token={ORGANIZATION_ACCESS_TOKEN}&start_date=2014-03-10T00:00:00+00:00