Able to add energy usage

[mattxcnm]

Is there an endpoint exposed in the api for the energy use of the device? I see there is a graphic in the app, but it's unclear if that's just something they calculated based on estimates or if they actually know energy usage. I added the screenshots below.

Great integration! Thank you for taking the time to develop it. If needed I can also help look into the API next week.

[theOrakle]

I can see that there is a field binEnergyUsage set to true. You can turn on debug and get this dumped out in the log file...

I didn't reverse engineer "impact" area of the app as I didn't think there was any data there when I originally did it. but I can try over the next holiday break. Good find - I am interested in how you will look at the API... If you can get me the endpoint URI, I'm sure it's easy to add in.

2025-12-01 09:23:40.765 DEBUG (MainThread) [custom_components.mill] {'authToken': '<redacted>', 'devices': [{'device_id': '<redacted>', 'nickname': 'Kitchen'}], 'email': '<redacted>', 'userId': '<redacted>', 'minMobileAppVersion': '2.18.3', 'configs': {'featureFlags': {'alwaysUnlockedLidLockOption': True, 'binEnergyUsage': True, 'binHistory': True, 'canOverrideCharcoalFilterStatus': True, 'charcoalFilter': True, 'chartridgeInstallation': False, 'chewieUM': False, 'coMoOobeFlow': False, 'disableDeviceInfoLocalInAppNotifications': False, 'disableDryAndGrindTipsLocalInAppNotification': False, 'disableOfflineLocalInAppNotification': False, 'disablePickupReminderLocalNotification': False, 'eppoFeatureFlags': True, 'inAppImpact': True, 'inAppNotifications': True, 'vacationModeSelection': True, 'vacationModeSelectionForO1': True, 'stickyPickups': True, 'storageTips': False, 'purchasePickups': True, 'multiBin': True, 'millstones': True, 'yearInReview': False}}}

2025-12-01 09:23:41.617 DEBUG (MainThread) [custom_components.mill] {'<redacted>': {'deviceId': '<redacted>', 'shadowInitialized': True, 'oscarVersion': 2, 'shadowVersion': 142744, 'deviceClaimToken': '<redacted>', 'nextDgoCycleStartTime': '2025-12-04T04:00:11Z', 'currentCycleStartTime': '2025-11-30T04:00:14Z', 'currentStageMandatoryEndTime': '2025-11-30T07:16:15Z', 'dgoCycle': {'desired': None, 'reported': 'Idle'}, 'dgoStage': {'desired': None, 'reported': 'Idle'}, 'dgoActiveStatus': True, 'dgoInactiveReason': [], 'sanitizeDuration': 0, 'cooldownDuration': 60, 'lastDgoCycleStartTime': '2025-11-30T04:00:14Z', 'lastDgoCycleEndTime': '2025-11-30T08:50:16Z', 'lastDgoCycleProcessedMass': 0.64999, 'lastDgoCycleStartMethod': 'Scheduled', 'lastDgoCycleEndMethod': 'Finished', 'lastDgoCycleSkipped': True, 'lastDgoCycleSkippedTime': '2025-12-01T04:00:13Z', 'currentDgoCycleStartMethod': 'Scheduled', 'lidLockState': False, 'safetyLock': False, 'massInBucket': 1.85398, 'firmwareVersion': 'comms:rls-v01.10.11-4d48265;control:rls-v01.10.11-4d48265', 'grinderState': 'Normal', 'bucketMissing': False, 'lastEmptyTime': '1970-01-01T00:00:00Z', 'massAddedSinceBucketEmpty': 4.80499, 'unprocessedMass': 0.08999, 'timeZone': 'America/Chicago', 'childLockEnabled': {'desired': False, 'reported': False}, 'childLock': False, 'dgoSafetyLockEnabled': {'desired': True, 'reported': True}, 'errorCode': [], 'dgoRequiredLock': False, 'lidOpenState': False, 'bucketFullness': 'Low', 'replaceCharcoalFilter': None, 'deltaMR': 0.75682, 'retareSuggested': False, 'lastDgoInactiveTimeoutReason': None, 'vacationModeSelection': {'desired': None, 'reported': 'Clean'}, 'dgoUserSchedule': {'desired': None, 'reported': [79211, 79211, 79211, 79211, 79211, 79211, 79211]}, 'dgoInactiveForOneHour': False, 'failureDetectedCloud': False, 'failureDetectedCloudReason': None, 'otaStatus': None, 'online': True, 'scheduledHipStartTime': {'desired': 79211, 'reported': 79211}, 'nextDgoCycleDuration': 9000, 'currentCycleEndTime': '2025-11-30T09:16:18Z', 'heatWarningStatus': False, 'nextDgoCycleDurationRange': {'lowerBound': 9000, 'upperBound': 9000}, 'currentCycleEndTimeRange': {'lowerBound': None, 'upperBound': None}, 'currentCycleEndTimePending': False, 'dayOfTheWeekScheduleSelected': False, 'lidLockSetting': {'desired': 'LockedWhenHot', 'reported': 'LockedWhenHot'}, 'grinderStateLastUpdatedAt': 1764083365}}

[mattxcnm]

@theOrakle I found the energy data endpoint. Only monthly basis, but still something. I also noted some other endpoints below, if interested.

GET https://cloud.api.mill.com/v1/feature_data/[userId]

{
  "impact": {
    "bags_of_food_waste": 1,
    "cumulative_food_waste_diverted": 7.528,
    "cumulative_food_waste_diverted_estimate": 0.0,
    "historical_food_waste_data": {
      "by_month": [
        {
          "date": "2025-11-15",
          "kg": 2.554
        },
        {
          "date": "2025-12-15",
          "kg": 4.974
        }
      ],
      "avg_monthly_scraps": 2.554
    },
    "historical_food_waste_data_estimate": {
      "by_month": [],
      "avg_monthly_scraps": 0
    },
    "historical_energy_use_data": {
      "by_month": [
        {
          "date": "2025-11-15",
          "kwh": 1.313
        },
        {
          "date": "2025-12-15",
          "kwh": 5.425
        }
      ]
    },
    "co2": {
      "miles_driven": 0,
      "co2e_kg": 0
    },
    "total_chickens_fed_from_send_back": 0
  },
  "referrals": {
    "referral_data": [
      {
        "referral_title": "Give $150, get $100 in Mill credit",
        "body": "Share your referral code and gift friends with a special Mill offer. ",
        "image_url": "https://cdn.sanity.io/images/n6zblyp8/production/3d1b3690010b2dafccee549f3ddfcf631ebf85a2-1029x330.png",
        "referral_bonus": "150",
        "referee_bonus": "100",
        "share_copy": "I love my Mill and think you will too. It helps you waste less and keep your kitchen clean. Order with my link and get $150 off!",
        "terms": {
          "title": "See terms.",
          "path": "/legal/referral-program-terms-and-conditions"
        },
        "referral_codes": {
          "share": "<redacted>",
          "qr": "redacted",
          "copy": "redacted"
        }
      }
    ]
  },
  "millstones": []
}

Other endpoints:

GET cloud.api.mill.com/v1/cms/food_index Contains food library and content
GET cloud.api.mill.com/v1/cms/food_collection Contains food library categories
GET cloud.api.mill.com/v1/cms/app_copy
GET cloud.api.mill.com/v1/cms/guide_articles
GET cloud.api.mill.com/v1/[userId]/year_in_review "null" for me, but maybe populated for others

[mattxcnm]

@theOrakle Thinking about this more. It would probably be easiest to simply sum all energy values listed in that main '"by_month": [' section so that the sensor value returns essentially total energy use, which can then be used in the energy dashboard. Each time the integration gets this API data it should update in near-real-time and should give better insight into energy use.

Additional sensors could include the current month usage by filtering for the most recent. Issues may come up if after many years not all the months are returned by the API so you'd lose energy once the older months stop being reported.

I'd be more than happy helping to write the code, but I'm still learning how to write HACS integrations.