API Reference

Use this API to obtain the target device's current state information including if the device is powered on and online, the set color, and brightness.

📘

Supported Device Models

This API is for Govee devices such as lights, plugs, and switches.

Click here for a full list of supported device models. H6160, H6163, H6104, H6109, H6110, H6117, H6159, H7022, H6086, H6089, H6182, H6085, H7014, H5081, H6188, H6135, H6137, H6141, H6142, H6195, H7005, H6083, H6002, H6003, H6148, H6052, H6143, H6144, H6050, H6199, H6054, H5001, H6154, H6072, H6121, H611A, H5080, H6062, H614C, H615A, H615B, H7020, H7021, H614D, H611Z, H611B, H611C, H615C, H615D, H7006, H7007, H7008, H7012, H7013, H7050, H6051, H6056, H6061, H6058, H6073, H6076, H619A, H619C, H618A, H618C, H6008, H6071, H6075, H614A, H614B, H614E, H618E, H619E, H605B, H6087, H6172, H619B, H619D, H619Z, H61A0, H7060, H610A, H6059, H7028, H6198, H6049, H7031, H7032, H61A1, H61A2, H61B2, H7061, H6067, H6066, H6009, H7041, H7042, H604A, H6173, H615E, H604B, H6091, H7051, H7062, H618F, H605D, H6046, H601A, H61A3, H610B, H6047, H7065, H61E1, H6057, H604C, H6065, H605C, H705A, H705B, H7055, H61A5, H6078, H604D, H6168, H6601, H70B1, H61A8

🚧

Online Status is Cached

Online functionality is provided through a cache system. However, it may occasionally provide incorrect information. To ensure smooth operation, it is recommended that third-party developers allow users to send control commands even when the online status is reported as false. This way, users can still control the device even if the cache is inaccurate.

Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

MAC address of the device.

string

Product model of the device.

Responses

429

Too Many Requests

Rate limit exceeded, retry in # seconds.

500

Internal Error

Language
Credentials