UP API Overview

Authentication

Authentication for the UP API is done through a POST to the https://jawbone.com/user/signin/login end-point including the email, pwd and service form variables. For example:

curl -X POST -d "email=someemail" -d "pwd=password" -d "service=nudge" https://jawbone.com/user/signin/login

which returns a rather large JSON object. The important parts are this:

{
    "user": {
        "xid": "someuniqueid",
    },
    "token": "_somereallylongtokengoeshere"
}

API Request Format

Once the XID and token has been retrieved, you can now make API requests to the main nudge API endpoint. For example:

curl -X GET --header "User-Agent:Nudge/2.1.10 CFNetwork/609 Darwin/13.0.0" --header "x-nudge-token:__tokenGoesHere__" https://jawbone.com/nudge/api/v.1.0/users/__xidGoesHere__/social

Resources

Method	End Point	Description
GET	/social	Top level social "feed" for the specified XID
GET	/healthCredits	Steps information by day for the last 30 days for the specified XID
GET	/sleeps	Sleep information by day for the last 30 days for the specified XID
GET	/workouts	Workout information by day for the last 30 days for the specified XID