We're making some changes to the Google Fit APIs. Learn about how these changes might affect your app. Read our new policy.

Working with Sessions

The Fitness REST API lets you create and obtain sessions. Sessions represent a time interval during which users perform a fitness activity.

Sessions are represented by the Users.session resource.

Activities are stored in an 'ActivityType' integer.

Insert a session

This example demonstrates how to insert a session.

HTTP method
PUT
Request URL
https://www.googleapis.com/fitness/v1/users/me/sessions/someSessionId
Request body
{
  "id": "someSessionId",
  "name": "My example workout",
  "description": "A very intense workout",
  "startTimeMillis": 1396710000000,
  "endTimeMillis": 1396713600000,
  "version": 1,
  "lastModifiedToken": "exampleToken",
  "application": {
    "detailsUrl": "http://example.com",
    "name": "Foo Example App",
    "version": "1.0"
  },
  "activityType": 1
}

Response

The response is a 200 OK status code. The response body contains a JSON representation of the session.

Curl command
$ curl --header "Authorization: Bearer ya29.1.yourtokenvalue" -X PUT \
--header "Content-Type: application/json;encoding=utf-8" -d @createsession.json \
"https://www.googleapis.com/fitness/v1/users/me/sessions/someSessionId"

List existing sessions

This example demonstrates how to list existing sessions from April 2014.

HTTP method
GET
Request URL
https://www.googleapis.com/fitness/v1/users/me/sessions?startTime=2014-04-01T00:00:00.000Z&endTime=2014-04-30T23:59:59.999Z
Request body
None.
Response
The response is a 200 OK status code. The response body contains JSON representations of all existing sessions that match the start and end times provided in the query parameters.
Curl command
$ curl --header "Authorization: Bearer ya29.1.yourtokenvalue" -X GET \
--header "Content-Type: application/json;encoding=utf-8" \
"https://www.googleapis.com/fitness/v1/users/me/sessions?startTime=2014-04-01T00:00:00.000Z&endTime=2014-04-30T23:59:59.999Z"