Please help with Case number 33989346 for intraday access to fitbit data

[stepgether]

Hello Team,

I am excited and waiting to do development of a new app using fitbit intraday data. I have submitted a request "33989346" for intraday access but havent got any reply yet. It has been 2 days since I submitted the request.

Could you please help track the request and suggested generally how much time it takes to get a request approved please.

Thanks,

[JohnFitbit]

Hi @stepgether,

Welcome to the forums!

I'll reply to your case (33989346) and provide you with your update there.

Thanks!

[stepgether]

Hello John, Thanks for the follow up. Quick question. Is it possible to have a fitbit app .. and then use device API to collect data from fitbit and send it to a custom http rest endpoint for some aggregation ?

[JohnFitbit]

@stepgether Can you clarify what you mean by Fitbit app? Are you referring to the actual Fitbit app or are you referring to a smartwatch app for the Fitbit app gallery?

Also, what type of data are you looking to collect? When you say Device API, it sounds like you are looking to pull raw data/real time data from the device's sensors. Is that correct?

[stepgether]

Yes, smart watch app. The data in question is for e.g. real time activity data from deivce sensors.

[kevmurph]

Hi I was wondering if you got any response to you question ?

Thanks a mil,

[JohnFitbit]

@stepgether @kevmurph,

I apologize for the delayed response.

The Web API does not support real-time/raw data from the sensors, but the Device API can.

I recommend posting any Device API related question in our SDK forums, where you can be provided with further assistance.

If you have any questions regarding the Web API, please let me know and I'll be happy to assist you further.

I hope this helps!

[kevmurph]

Hi @JohnFitbit,

Many thanks for your reply. 

Would you be able to tell be can I access heart rate data through the web api.

So if i exercised on the 1st of the month would I be able to access that heart rate data through the web api on the 2nd?

Thanks a mil,

Kevin

[JohnFitbit]

@kevmurph Absolutely!

You can use our Web API explorer to test the Web API endpoints as well. You'll need to allow API explorer to read your data through the authorization flow by following these steps:

1. Go to https://dev.fitbit.com/build/reference/web-api/explore/
2. Click "Authorize" on the right
3. Select the scopes, heart rate for example
4. Click "Authorize"

Once you've authorized the API explorer, find the "Get Heart Rate Time Series" endpoint to get your heart rate totals for a specific date or date range. Click anywhere on that line and you should see additional information for the endpoint and a button to "try it out". Click this and enter the dates in the requested format, then execute. You should see a response similar to this:

{
  "activities-heart": [
    {
      "dateTime": "2020-01-01",
      "value": {
        "customHeartRateZones": [],
        "heartRateZones": [
          {
            "caloriesOut": 1772.69736,
            "max": 93,
            "min": 30,
            "minutes": 1408,
            "name": "Out of Range"
          },
          {
            "caloriesOut": 96.54939,
            "max": 130,
            "min": 93,
            "minutes": 18,
            "name": "Fat Burn"
          },
          {
            "caloriesOut": 7.19502,
            "max": 158,
            "min": 130,
            "minutes": 1,
            "name": "Cardio"
          },
          {
            "caloriesOut": 0,
            "max": 220,
            "min": 158,
            "minutes": 0,
            "name": "Peak"
          }
        ],
        "restingHeartRate": 55
      }
    },
    {
      "dateTime": "2020-01-02",
      "value": {
        "customHeartRateZones": [],
        "heartRateZones": [
          {
            "caloriesOut": 1470.60375,
            "max": 93,
            "min": 30,
            "minutes": 1309,
            "name": "Out of Range"
          },
          {
            "caloriesOut": 14.5845,
            "max": 130,
            "min": 93,
            "minutes": 3,
            "name": "Fat Burn"
          },
          {
            "caloriesOut": 0,
            "max": 158,
            "min": 130,
            "minutes": 0,
            "name": "Cardio"
          },
          {
            "caloriesOut": 0,
            "max": 220,
            "min": 158,
            "minutes": 0,
            "name": "Peak"
          }
        ],
        "restingHeartRate": 55
      }
    }
  ]
}

For this example, I used the dates in your example scenario for 2020-01-01 to 2020-01-02.

https://api.fitbit.com/1/user/-/activities/heart/date/2020-01-01/2020-01-02.json

I hope this helps. Please let me know if you have any additional questions.

[kevmurph]

Hi @JohnFitbit 

Many thanks for your detailed reply I am starting to get an understanding of what is available.

Just one more question though.

In my example 'If I worked out for 1 hour' that day between 1pm - 2pm is it possible to ONLY take the data(calories burned) for this time period? 

OR 

Am I able to pull information from the exercise goals section so that I can get data from a particular training session?

Thanks again,

Kind regards,
Kevin

[JohnFitbit]

@kevmurph Yes, using the GET Activity Intraday Time Series endpoint, you can fetch data for a specific day (by using start and end dates on the same day or a period of 1d) and time frame, the response will include extended intraday values with a 1-minute (or 15) detail level for that day. For the following example, I chose 15min detail-level as to prevent creating an unnecessarily long post.

For example:

https://api.fitbit.com/1/user/-/activities/calories/date/2020-01-01/1d/15min/time/13%3A00/14%3A00.json

Response:

{
  "activities-calories": [
    {
      "dateTime": "2020-01-01",
      "value": "71.66"
    }
  ],
  "activities-calories-intraday": {
    "dataset": [
      {
        "level": 0,
        "mets": 199,
        "time": "13:00:00",
        "value": 19.348770141601562
      },
      {
        "level": 0,
        "mets": 185,
        "time": "13:15:00",
        "value": 17.987550735473633
      },
      {
        "level": 0,
        "mets": 172,
        "time": "13:30:00",
        "value": 16.723560333251953
      },
      {
        "level": 0,
        "mets": 171,
        "time": "13:45:00",
        "value": 16.62632942199707
      },
      {
        "level": 0,
        "mets": 10,
        "time": "14:00:00",
        "value": 0.9722999930381775
      }
    ],
    "datasetInterval": 15,
    "datasetType": "minute"
  }
}

You'll see your calories burned every 15 mins for that selected time frame, as well as total calories burned for that time frame at the top of the response.

I hope this helps. Let me know if you have any additional questions.

[kevmurph]

Thanks a million for your detailed reply John it's very helpful.

Kind regards,
Kevin