Make your product
work with UP.

Band Events

Get the band events

Returns the band hardware events generated by the UP24 bluetooth connected band. These events include entry and exit of sleep mode, and entry and exit of stopwatch (workout) mode. This endpoint only tracks the specific events coming from the band itself (not manual or 3rd party events). For the actual data for workout or sleep events, please see those respective endpoints.
URI Method Response Type Returns
/nudge/api/v.1.1/users/@me/bandevents GET application/json BandEvents
Parameter Type Description
date int Date, formatted as YYYYMMDD. If omitted, returns the information for today.
start_time int To be used along with end_time. Epoch timestamp that denotes the start of the time range queried for events.
end_time int To be used with start_time. Epoch timestamp that denotes the end of the time range queried for events.
created_after int Epoch timestamp to list events that are created later than the timestamp.

Example:

GET https://jawbone.com/nudge/api/v.1.1/users/@me/bandevents HTTP/1.1
Host: jawbone.com
	

Will return:

HTTP 200 OK
{
   "meta": 
   {
      "user_xid": "6xl39CsoVp2KirfHwVq_Fx",
      "message": "OK",
      "code": 200
      "time": 1391736999
   },
   "data":
   {
      "items": 
      [{
         date: 20140207,
	 action: "exit_sleep_mode:,
         tz: "America/Los Angeles",
         time_created: 1392734465
      },{ 
         date: 20140206,
	 action: "enter_sleep_mode:,
         tz: "America/Los Angeles",
         time_created: 1392702674
      },{ 
         date: 20140206,
	 action: "exit_stopwatch_mode:,
         tz: "America/Los Angeles",
         time_created: 1391724000
      },{ 
         date: 20140206,
	 action: "enter_stopwatch_mode:,
         tz: "America/Los Angeles",
         time_created: 1391720400
      }],
      “size”: 4
   }   
}
	
Data Value Type Description
date int Date when this event was generated factoring in user timezone, formatted as YYYYMMDD.
action string Type of event. Current options: enter_stopwatch_mode and exit_stopwatch_mode for workouts, and enter_sleep_mode and exit_sleep_mode for sleep.
tz string Time zone when this event was generated. Whenever possible, Olson format (e.g., "America/Los Angeles") will be returned, otherwise the GMT offset (e.g., "GMT+0800") will be returned.
time_created int Epoch timestamp when the event was generated.