Fitness Activities
Fitness records return data for activities that are undertaken with the express purpose of exercising. These activities have a defined duration (time, distance, elevation, etc.). Activities are stored in the items array structure as follows:
Example
GET https://api.validic.com/v1/organizations/{ORGANIZATION_ID}/users/{USER_ID}/fitness.json?access_token={ORGANIZATION_ACCESS_TOKEN}
GET https://api.validic.com/v1/organizations/5176906c6deddac02c000001/users/51 552cd7fded0807c4000017/fitness.json?access_token=e7ba1f04e88f25d399a91c8cb cd72300e01309e96b7725e40b49cd1effaa5deb 200 { "summary": { ... }, "fitness": [ { "_id": "51552cd7fded0807c400001f", "timestamp": "2013-03-10T07:12:16+00:00", "utc_offset": "+00:00", "type": "Walking", "intensity": "low", "start_time": "2013-03-10T07:12:16+00:00", "distance": 2600, "duration": 2460, "calories": 350, "source": "sample_app", "source_name": "Sample App", "last_updated": "2013-03-10T07:12:16+00:00" } ] }
Params
Field
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.
intensity
String
String Subjective intensity with which an activity was performed. Examples are: low, medium, high. Returned as provided by source.
start_time
String
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
Total distance for the activity in meters
duration
Double
Duration of the activity 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)
For more information regarding the difference between Fitness and Routine data types, please reference our Knowledge Base Article.