Skip to end of metadata
Go to start of metadata



This endpoint is deprecated. It will not return heart rate data from Charge HR and Surge. New heart rate endpoints are available from API-Get-Time-Series and API-Get-Intraday-Time-Series.


Get an average values and a list of user's heart rate log entries for a given day in the format requested. Heart rate data available only to the authorized user. Heart rate log entries in response are sorted exactly the same as they are presented on the Fitbit website. We always include all heart rate trackers in the <average> section of the response body (with zero average values for the days with no measurements) to allow to seamlessly fetch a list of all additional user created custom trackers.

Access Type: Read

Rate Limited: Yes

Resource URL

GET /<api-version>/user/-/heart/date/<date>.<response-format>


The API version. Currently 1.


The date in the format YYYY-mm-dd.


The response format. Currently supported response formats are json and xml for responses in JSON and XML, respectively.



Via token credentials. All authentication header parameters are required.

Request Headers



API Response in format requested: JSON or XML.

Response body format

Note: Text within <> is a descriptive place holder for a value.

JSON Response

Note: Text within [] is a descriptive place holder for a value.

XML Response


JSON Response
XML Response
  • No labels