DEPRECATED

The v1 endpoints have been deprecated and will be removed after 1H 2014. Please use the current version instead.

Daily summaries

Required scope: activity

Get daily activity summaries for user, including step count, distance and duration for each activity.
Final summary for a particular date will only be available at earliest after midnight in the user’s current timezone.

Single day

 GET /user/summary/daily/<date>

Required parameter:

  • date: date in yyyyMMdd or yyyy-MM-dd format

Specific week

Uses ISO8601 week-numbering.

 GET /user/summary/daily/<week>

Required parameter:

  • week: week in yyyy-’W’ww format, for example 2013-W09

Specific month

 GET /user/summary/daily/<month>

Required parameter:

  • month: month in yyyyMM or yyyy-MM format

Date range

Maximum range in one query between from and to date is 31 days.

GET /user/summary/daily?from=<from>&to=<to>

Required parameter:

  • from: range start in yyyyMMdd or yyyy-MM-dd format
  • to: range end in yyyyMMdd or yyyy-MM-dd format

Past days

Maximum range is 31 days in on query.

GET /user/summary/daily?pastDays=<pastDays>

Required parameter:

  • pastDays: how many past days to return, including today (in users current time zone)

Response

All the daily summary API calls return a JSON array of dates and summaries

[{
    "date": "20130315",
    "summary": [
        {
            "activity": "wlk",
            "duration": 2133,
            "distance": 1847,
            "steps": 2500
        },
        {
            "activity": "run",
            "duration": 254,
            "distance": 436,
            "steps": 624,
            "calories": 99
        },
        {
            "activity": "cyc",
            "duration": 2688,
            "distance": 4049,
            "calories": 999
        }
    ]
},
{
    "date": "20130316",
    "summary": [
        {
            "activity": "wlk",
            "duration": 3333,
            "distance": 2222,
            "steps": 1999,
            "calories": 120
        },
        {
            "activity": "run",
            "duration": 123,
            "distance": 345,
            "steps": 456,
            "calories": 60
        }
    ],
    "caloriesIdle": 1785
},
{
    "date": "20130317",
    "summary": null,
    "caloriesIdle": 1785
}]
  • date: summary date, in format yyyyMMdd
  • summary: JSON array of daily activity summaries or null if there is no summary available for the date
    • activity: one of “wlk” (walking), “run” (running) or “cyc” (cycling)
    • duration: duration of the activity in seconds
    • distance: distance for the activity in meters
    • steps (optional): step count for the activity (if applicable)
    • calories (optional): calories burn for the activity in kcal, on top of the idle burn. Available if user has at least once enabled calories
  • caloriesIdle (optional): daily idle burn in kcal. Available if user has at least once enabled calories