Lodol Docs

Fitbit

API actions for the Fitbit integration.

Fitbit

Track Fitbit activity, sleep, and wellness metrics.


Get daily activity summary

Get the daily activity summary for a specific date.

Parameters

ParameterTypeRequiredDescription
datestringYesThe date to get activity for (YYYY-MM-DD format).

Response

{
  "active_minutes": 45,
  "calories": 2100,
  "distance": 6.2,
  "steps": 8500
}

Get heart rate intraday

Get intraday heart rate data for a specific date.

Parameters

ParameterTypeRequiredDescription
datestringYesThe date to get heart rate data for (YYYY-MM-DD format).
detail_levelstringNoData granularity: '1sec', '1min', '5min', or '15min'.

Response

{
  "activities-heart": [
    {
      "dateTime": "2024-01-15",
      "value": {
        "restingHeartRate": 62
      }
    }
  ],
  "activities-heart-intraday": {
    "dataset": [
      {
        "time": "00:00",
        "value": 58
      }
    ]
  }
}

Get sleep logs

Get sleep logs for a specific date.

Parameters

ParameterTypeRequiredDescription
datestringYesThe date to get sleep logs for (YYYY-MM-DD format).

Response

{
  "sleep": [
    {
      "duration": 28800000,
      "endTime": "2024-01-16T06:30:00.000",
      "logId": 12345,
      "startTime": "2024-01-15T22:30:00.000"
    }
  ],
  "summary": {
    "totalMinutesAsleep": 420,
    "totalTimeInBed": 480
  }
}

Get weight logs

Get weight logs for a specific date.

Parameters

ParameterTypeRequiredDescription
datestringYesDate for the weight logs (yyyy-MM-dd).

Response

{
  "weight": [
    {
      "bmi": 23.1,
      "date": "2024-01-15",
      "logId": 111,
      "weight": 75.5
    }
  ]
}

Log activity

Log a manual activity entry to Fitbit.

Parameters

ParameterTypeRequiredDescription
activity_namestringYesName of the activity to log.
duration_minutesnumberYesDuration of the activity in minutes.
datestringYesDate for the activity (yyyy-MM-dd).
start_timestringYesStart time of the activity (HH:mm).
caloriesnumberNoOptional calories burned estimate.

Response

{
  "activityLogId": 123456789
}

Log water intake

Log water intake for a specific date.

Parameters

ParameterTypeRequiredDescription
datestringYesDate of the water entry (yyyy-MM-dd).
amount_litersnumberYesLiters of water consumed.

Response

{
  "waterLogId": 987654321
}

On this page