Activities By Experience Type

The /me/sport/activities/{experienceType} endpoint returns the User's sport activity for the specified experience type as a paginated list. Activities are returned in order by the most recent.

Note: This endpoint does not return GPS data, which can (only) be retrieved for one activity at a time by calling the /me/sport/activities/{activityId}/gps endpoint.


Query Parameters
Name Type Required? Description
access_token String Y User's access token
experienceType String Y The Experience Type by which to filter the list (FUELBAND or RUNNING)
offset Integer N Pagination – first record to retrieve (starts at 1)
count Integer N Pagination – number of records to retrieve (default 5)
startDate String N The Activity list's start date in ISO8601 standard format, 'yyyy-mm-dd'
endDate String N The activity list's end date in ISO8601 standard format, 'yyyy-mm-dd'

Response Fields

Distances and weights are returned in metric units. Dates and times are returned in UTC following ISO8601 standard formats.

Name Type Description
data Array The list of the User's Activities
activityId String The sport activity unique identifier
calories Number Number of calories burned during the Activity
fuel Number Amount of fuel gained during the Activity
distance Number Distance traveled during the Activity
steps Number Number of steps taken during the Activity
duration Number The amount of time the Activity lasted in standard ISO8601 format
type String Type of tag
startTime String The Activity's start time in UTC, standard ISO8601 format
activityTimeZone String Timezone the Activity was captured in
status String The status of the activity. IE: IN_PROGRESS, COMPLETED
deviceType String Device the activity was done with
tags Array Extra detail User entered about the Activity
value String The value or detail of the tag
paging Object Paging details of the list
next String The URI and query parameters for the next page of results in the list
previous String The URI and query parameters for the previous page of results in the list

Sample Request

Sample Response
{ "data": [ { "activityId": "2112480444", "activityType": "RUN", "startTime": "2013-03-10T17:22:55Z", "activityTimeZone": "GMT-08:00", "status": "COMPLETE", "deviceType": "SPORTWATCH", "metricSummary": { "calories": 569, "fuel": 1422, "distance": 6.548600196838379, "steps": 0, "duration": "0:43:43.000" }, "tags": [], "metrics": [] }, { "activityId": "2110978807", "activityType": "RUN", "startTime": "2013-03-07T15:13:05Z", "activityTimeZone": "GMT-08:00", "status": "COMPLETE", "deviceType": "SPORTWATCH", "metricSummary": { "calories": 62, "fuel": 160, "distance": 0.7139000296592712, "steps": 0, "duration": "0:04:30.000" }, "tags": [], "metrics": [] }, { "activityId": "2109875327", "activityType": "RUN", "startTime": "2013-03-02T15:39:18Z", "activityTimeZone": "GMT-08:00", "status": "COMPLETE", "deviceType": "SPORTWATCH", "metricSummary": { "calories": 316, "fuel": 785, "distance": 3.638000011444092, "steps": 0, "duration": "0:23:24.000" }, "tags": [], "metrics": [] }, { "activityId": "2109867626", "activityType": "RUN", "startTime": "2013-03-02T01:52:27Z", "activityTimeZone": "GMT-08:00", "status": "COMPLETE", "deviceType": "SPORTWATCH", "metricSummary": { "calories": 305, "fuel": 517, "distance": 3.5195999145507812, "steps": 0, "duration": "0:45:14.000" }, "tags": [], "metrics": [] }, { "activityId": "2108458879", "activityType": "RUN", "startTime": "2013-03-02T01:39:29Z", "activityTimeZone": "America/Los_Angeles", "status": "COMPLETE", "deviceType": "IPHONE", "metricSummary": { "calories": 275, "fuel": 671, "distance": 4.599837303161621, "steps": 0, "duration": "0:56:57.019" }, "tags": [ { "tagType": "TEMPERATURE", "tagValue": "TEMPERATURE" }, { "tagType": "WEATHER", "tagValue": "CLOUDY" } ], "metrics": [] } ], "paging": { "next": "/me/sport/activities/RUNNING?access_token={access_token}&offset=6" } }

Error Codes
Error Code Message
0x00000008 Invalid Experience Type
0x00000013 User authentication is invalid
0x00000014 Start Date has invalid format
0x00000015 End Date has invalid format

Try it out
Get My Access Token
« Back