Activity Detail

get

The Activity Detail (GET v1/me/sport/activities/{activityId}) endpoint provides details of the user's Activities. Each Activity has a unique Activity ID. Activity details include the Activity’s type, start time, and duration, the NikeFuel earned and calories burned during the Activity, and the type of device that recorded the Activity.

The Metric Type values returned by the Activity Detail endpoint will vary depending on the Activity. Devices and apps can use these Metric Type values (e.g., fuel) to display information to enhance the user’s experience.

Note:  Use the ALL_DAY Activity Type to receive NikeFuel from multiple or overlapping Activities. See NikeFuel Across Activities for more information.

Note:  This endpoint does not return GPS data. Use the GPS Data endpoint to retrieve GPS data one Activity at a time.

Test Console

Request

GEThttps://api.nike.com/v1/me/sport/activities/{activityId}

QUERY PARAMETERS

Note: The {activityId} path parameter in the endpoint URL is the unique Activity identifier for the requested Activity.

Name Type Required? Description
access_token String Yes User's access token

Sample Request

GET https://api.nike.com/v1/me/sport/activities/8112000000000216951130015326137714293577?access_token={access_token}

Response

Response Body JSON Schema

RESPONSE BODY FIELDS

Distances and weights are returned in metric units (see Metric Types for more information). Dates and times are returned in UTC following ISO8601 standard formats.
Name Type Description
links Array List of links to related resources (see the HATEOAS page for more information)
activityId String
Unique Activity identifier
activityType
String

Type of Activity performed (see Activity Types for full list)

startTime
String

Start time of Activity in UTC standard ISO8601 format

activityTimeZone
String

Time zone name in which the Activity occurred. Nike+ supports political time zones found in the IANA Time Zone Database (e.g., “America/Los_Angeles”) and Etc/GMT offset (e.g., “Etc/GMT-8”).

status
String

Status of the Activity (NONE, IN_PROGRESS, or COMPLETED)

deviceType
String
Device used to record the Activity
metricSummary
Object

Object containing summary metric data for the Activity

metricSummary.calories String
Number of calories burned during the Activity
metricSummary.fuel String
NikeFuel earned during the Activity. If the Activity Type is the ALL_DAY Activity Type, then the value of metricSummary.fuel will be the deduped NikeFuel across Activities (see NikeFuel Across Activities for more information).
metricSummary.distance String
Distance traveled during the Activity
metricSummary.steps String
Number of steps taken during the Activity
metricSummary.duration String
Duration of the Activity. The format is: Hour:Minute:Seconds.Milliseconds
tags
Array of Objects
Additional details the user entered about the Activity
tags[n].tagType
String
Type of tag
tags[n].tagValue
String

Value of tag

metrics
Array of Objects

Metrics array contains metric data (interval unit, interval value, and Metric Type) and the array of metric values.

metrics[n].intervalMetric
Integer
Interval in which the metric's values were sampled
metrics[n].intervalUnit
String

Unit of the metric's interval value (metrics[n].intervalMetric), e.g., "SEC" for seconds

metrics[n].metricType
String
Metric Type of the metric
metrics[n].values
Array of Strings
The stream of values for the metric
isGpsActivity
Boolean
Whether this Activity contains GPS data

Sample Response Body

{
    "links": [
        {
            "rel": "self",
            "href": "https://api.nike.com/v1/me/sport/activities/2683000000011936851080007062707485942202"
        }
    ],
    "activityId": "2683000000011936851080007062707485942202",
    "activityType": "RUN",
    "startTime": "2009-12-12T14:28:36Z",
    "activityTimeZone": "America/Dawson",
    "status": "COMPLETE",
    "deviceType": "SPORTWATCH",
    "metricSummary": {
        "calories": "295",
        "fuel": "1945",
        "distance": "9.19890022277832",
        "steps": "0",
        "duration": "0:22:26.000"
    },
    "tags": [
        {
            "tagType": "TERRAIN",
            "tagValue": "TRAIL"
        },
        {
            "tagType": "WEATHER",
            "tagValue": "SUNNY"
        }
    ],
    "metrics": [
        {
            "intervalMetric": 10,
            "intervalUnit": "SEC",
            "metricType": "DISTANCE",
            "values": [
                "0.025399999999999992",
                "0.026800000000000004",
                "0.027399999999999994",
                "0.028300000000000017"
            ]
        }
    ],
    "isGpsActivity": true
}

Error Codes

Please refer to Error Codes and Responses