Make your product
work with UP.

Moves

Get the user's move list

Returns the list of moves of the current user. This list can be paginated by date or timestamp.
URI Method Response Type Returns
/nudge/api/users/@me/moves GET application/json Collection>Move
Parameter Type Description
date int Date, formatted as YYYYMMDD. If omitted, returns the information for today.
page_token int Timestamp used to paginate the list of moves. The Developer must use the “next” link provided in the “links” section.
start_time int To be used along with end_time. Epoch timestamp that denotes the start of the time range queried for move events.
end_time int To be used with start_time. Epoch timestamp that denotes the end of the time range queried for move events.
updated_after int Epoch timestamp to list move events that are updated later than the timestamp. To be used with start_time to list events that were completed after said start_time.

Example:

GET https://jawbone.com/nudge/api/v.1.0/users/@me/moves?start_time=1383289200 HTTP/1.1
Host: jawbone.com
	

Will return:

HTTP 200 OK
{
   “meta”:
   {
      “user_xid”: “6xl39CsoVp2KirfHwVq_Fx”,
      “message”: “OK”,
      “code”: 200
      "time": 1386122022
   },
   “data”:
   {
      "items": 
      [{
         "xid": "40F7_htRRnQwoMjIFucJ2g",
         "title": "16,804 steps",
         "type": "move",
         "time_created": 1384963500,
         "time_updated": 1385049599,
         "time_completed": 1385099220,
         "date": 20131121
         "snapshot_image": "/nudge/image/e/1385107737/40F7_htRRnQwoMjIFucJ2g/grEGutn_XYZ.png"
         "details": 
         {
            "distance": 14745,
            "km": 14.745,
            "steps": 16804,
            "active_time": 11927,
            "longest_active": 2516,
            "inactive_time": 32760,
            "longest_idle": 27180,
            "calories": 1760.30480012,
            "bmr_day": 1697.47946931,
            "bmr": 1697.47946931,
            "bg_calories": 1099.9439497,
            "wo_calories": 388.506116077,
            "wo_time": 11484,
            "wo_active_time": 3902,
            "wo_count": 2,
            "wo_longest": 2516,
            "tz": "America/Los Angeles",
            "tzs": 
            [
               [1384963500, "America/Phoenix"],
               [1385055720, "America/Los_Angeles"]
            ],
            "hourly_totals": 
            {
                "2013112101":
                {
                    "distance": 1324,
                    "calories": 90.0120018125,
                    "steps": 1603,
                    "active_time": 793,
                    "inactive_time": 220,
                    "longest_active_time": 302,
                    "longest_idle_time": 780
                },
                "2013112101":
                {
                    "distance": 626,
                    "calories": 47.0120018125,
                    "steps": 455,
                    "active_time": 246,
                    "inactive_time": 260,
                    "longest_active_time": 203,
                    "longest_idle_time": 650
                },
                ... more hours ...
            }
         }
      },
      {
      ... more items ....
      }],
      "links": 
      {
         "next": "/nudge/api/v.1.0/users/6xl39CsoVp2KirfHwVq_Fx/moves?page_token=1384390680"
      },
      “size”: 10
   }   
}
	
Data Value Type Description
xid string Unique ID for this event. Can be used to retrieve data for this specific event, see below.
title string Title of this move.
type string Type of event, in this case a move.
time_created int Epoch timestamp when this move was created.
time_updated int Epoch timestamp when this move was last updated.
time_completed int Epoch timestamp when this move was completed.
date int Date when this move was created, formatted as YYYYMMDD.
snapshot_image URI Link to the image of this move event (relative, add prefix https://jawbone.com)
distance int Distance travelled, in meters.
km int Distance travelled, in kilometers.
steps int Number of steps taken.
active_time int Total active time for move, in seconds.
longest_active int Longest consecutive active period, in seconds.
inactive_time int Total inactive time for move, in seconds.
longest_idle int Longest consecutive inactive period, in seconds.
calories int Total calories burned. This is computed by this formula: wo_calories+bg_calories+bmr_day / 86400 * active_time
bmr_day int Estimated basal metabolic rate for entire day, in calories.
bmr int Estimated basal metabolic rate at time of last sync. For previous days should approximately equal bmr_day.
bg_calories int Calories directly from UP band activity outside the context of a workout.
wo_calories int Calories burned from workouts.
wo_time int Total time spent in workouts, in seconds.
wo_active_time int Actual active time during workout (where user was stepping) in seconds.
wo_count int Number of workouts logged during this move.
wo_longest int Longest workout period, in seconds.
tz string Earliest timezone recorded for this move event, Olson format.
tzs [epoch timestamp, timezone] Move can have more than one timezone associated with it if the user has crossed timezone in the given day. Epoch timestamp for the period starting in that time zone, and the time zone string.
hourly_totals JSON Data broken out by hour (values as above).
size int Number of items in this list.
Next URI Link to next page of data (relative, add https://jawbone.com as prefix).

Get the information about a specific move

Returns the detailed information of the given move.
URI Method Response Type Returns
/nudge/api/moves/{move_xid} GET application/json Move

Example:

GET https://jawbone.com/nudge/api/v.1.0/moves/40F7_htRRnQwoMjIFucJ2x HTTP/1.1
Host: jawbone.com
	

Will return:

HTTP 200 OK
{
   “meta”:
   {
      “user_xid”: “6xl39CsoVp2KirfHwVq_Fx”,
      “message”: “OK”,
      “code”: 200
      "time": 1386122022
   },
   “data”:
   {
      "xid": "40F7_htRRnQwoMjIFucJ2x",
      "title": "16,804 steps",
      "type": "move",
      "time_created": 1384963500,
      "time_updated": 1385049599,
      "time_completed": 1385099220,
      "date": 20131121
      "snapshot_image": "/nudge/image/e/1385107737/40F7_htRRnQwoMjIFucJ2g/grEGutn_XYZ.png"
      "details": 
      {
         "distance": 14745,
         "km": 14.745,
         "steps": 16804,
         "active_time": 11927,
         "longest_active": 2516,
         "inactive_time": 32760,
         "longest_idle": 27180,
         "calories": 1760.30480012,
         "bmr_day": 1697.47946931,
         "bmr": 1697.47946931,
         "bg_calories": 1099.9439497,
         "wo_calories": 388.506116077,
         "wo_time": 11484,
         "wo_active_time": 3902,
         "wo_count": 2,
         "wo_longest": 2516,
         "tz": "America/Los Angeles",
         "tzs": 
         [
            [1384963500, "America/Phoenix"],
            [1385055720, "America/Los_Angeles"]
         ],
         "hourly_totals": 
         {
            "2013112101":
            {
               "distance": 1324,
               "calories": 90.0120018125,
               "steps": 1603,
               "active_time": 793,
               "inactive_time": 220,
               "longest_active_time": 302,
               "longest_idle_time": 780
            },
            "2013112101":
            {
               "distance": 626,
               "calories": 47.0120018125,
               "steps": 455,
               "active_time": 246,
               "inactive_time": 260,
               "longest_active_time": 203,
               "longest_idle_time": 650
            },
            ... more hours ...
         }  
      }
   }
}
	

Get the user's move graphs

Returns the image of the given move.
URI Method Response Type Returns
/nudge/api/moves/{move_xid}/image GET image/png Binary image

Example:

GET https://jawbone.com/nudge/api/v.1.0/moves/40F7_htRRnSLLvJP0G6cbA/image HTTP/1.1
Host: jawbone.com
	

Will return:

Binary contents of the image.
	

Get move intensity

Returns a time-series of the move intensity during the day. Each entry is a tuple that contains a timestamp, and the average intensity during that period. Currently, it’s an arbitrary equidistributed list of timestamps.
URI Method Response Type Returns
/nudge/api/moves/{move_xid}/snapshot GET application/json Snapshot

Example:

GET https://jawbone.com/nudge/api/v.1.0/moves/40F7_htRRnSLLvJP0G6cbA/snapshot HTTP/1.1
Host: jawbone.com
	

Will return:

HTTP 200 OK
{
   “meta”:
   {
      “user_xid”: “b9yCLa3f01yf”,
      “message”: “OK”,
      “code”: 200,
      "time": 1386122022
   },
   “data”:
   [
      [1312369860, 41],
      [1312369920, 38],
      [1312369980, 0],
      ...
   ]
}