The Google Fit APIs, including the Google Fit REST API, will no longer be available after June 30, 2025. As of May 1, 2024, developers cannot sign up to use these APIs.

For instructions on which API or platform to migrate to, visit the Health Connect migration guide. For a comparison of Health Connect with the Google Fit APIs and the Fitbit Web APIs, visit the Health Connect comparison guide.

Learn more about Health Connect and how to integrate with the API.

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.