Manuals+

Govee Developer API Reference

Version 2.0

You can always get the latest API guide through the link below: https://govee-public.s3.amazonaws.com/developer-docs/GoveeDeveloperAPIReference.pdf

Govee Team

Table of Contents

F&Q

  1. I have a Bluetooth device. It does not support Wi-Fi. Is there an available API?

    No, only Wi-Fi devices support API.

  2. When I use Govee Home App to control the brightness of the device, the API will not display the changed status.

    The changed status can only be synchronized when the light is controlled via Wi-Fi, which means your phone Bluetooth needs to be turned off. Please recheck if you have turned off your phone Bluetooth.

  3. I have a problem using a third-party software, I am not a developer, can you solve the problem with a third-party software.

    Govee does not have supported third-party software that uses their API to integrate. Since Govee is not involved in it, they cannot diagnose or solve the problem. It is advised to contact the third-party support directly to solve the problem.

  4. How to refresh the API key?

    The Govee Developer API Key can be applied through the Govee Home App. The key is refreshed every time it is applied and will be sent to the email address.

  5. What can I do if the response status is not 200?

    Please read the “message” in the Response Body first. If the question persists, please send the Request Params and the value of “Date" and "X-traceld” showed in the Response Header, which would be helpful for debugging.

Getting Started with the Govee Developer API

Use the Govee Developer API to control devices and query device state.

The device models supported by the current version are:

Lights, Plugs, Switches:

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

Appliances:

H7121, H7122, H7123, H7120, H7141, H7142, H7130, H7131, H7132, H7150, H7160, H7101, H7111

Here are a few things to know before starting:

  1. How to use Govee Developer API key
  2. Rate Limiting

How to Use Govee Developer API Key

The Govee Developer API Key is used for authentication. Requests that require authentication will return 401 Unauthorized.

Use HTTP header 'Govee-API-Key' to send the Govee Developer API Key. Instructions on how to use it are available in the API examples.

Rate Limiting (Lights, Plugs, Switches)

The returned HTTP headers show the current rate limit status:

RateLimit StatusDescription
RateLimit-LimitThe maximum number of requests permitted to make.
RateLimit-RemainingThe number of requests remaining in the current rate limit window.
RateLimit-ResetThe time at which the current rate limit window resets in UTC epoch seconds.

Note: There are two levels of limits working together. Ensure your design does not reach any level of the limits. Otherwise, the HTTP response status will be 429.

  1. X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (This level of limit works on all APIs, meaning total requests from one user cannot exceed 10000 per day).

    Works on All APIsLimit
    All APIs10000 per day

  2. API-RateLimit-Limit, API-RateLimit-Remaining, API-RateLimit-Reset.

    EndpointLimit
    DeviceList10 per minute
    DeviceControl10 per minute per device
    DeviceState10 per minute per device

Rate Limiting (Appliances)

The rules for appliances are the same as those for Lights, Plugs, and Switches, as described in the

PDF preview unavailable. Download the PDF instead.

GoveeDeveloperAPIReference macOS Version 12.5.1 (Build 21G83) Quartz PDFContext Pages

Related Documents

Preview Govee Developer API Reference Version 1.5
Comprehensive reference guide for the Govee Developer API Version 1.5, detailing API key usage, rate limiting, supported device models, and endpoints for device listing, control, and state querying. Includes request/response examples and error handling.
Preview Govee Developer API Reference Guide
Comprehensive guide to the Govee Developer API, detailing endpoints for device control, state querying, rate limiting, and setup. Includes supported device models and API usage examples.
Preview Govee API Reference: Integrate Smart Devices with Govee API 1.0
Comprehensive Govee API 1.0 reference for developers to control and query Govee smart devices, including authentication, rate limiting, device listing, and device control commands.
Preview Signify v. Shenzhen Intellirocks: Patent Infringement Complaint for LED Lighting Products
Details of a patent infringement lawsuit filed by Signify North America Corporation and Signify Holding B.V. against Shenzhen Intellirocks Tech Co., LTD. concerning LED lighting products and technologies.
Preview Authorization Letter for Govee RGBIC LED Strip Lights FCC Certification
Official letter from Shenzhen Intellirocks Tech. Co., Ltd. authorizing LGAI Technological Center S.A. to manage FCC approval for Govee RGBIC LED Strip Lights models H619E, H619A, H619B, H619C, H619D, H619Z, H6168, H618A, H618C, H618E, H618F (FCC ID: 2AQA6-H619EA).
Preview Govee RGBIC LED Strip Lights Product Similarity Declaration
This document declares the electrical identity of various Govee RGBIC LED Strip Light models, including H619E, H619A, H619B, H619C, H619D, H619Z, H6168, H618A, H618C, H618E, and H618F, despite variations in length and appearance. It details adapter information for each model.
Preview Govee RGB LED Strip Light Model Similarity Declaration
This document from Shenzhen Qianyan Technology LTD declares the differences in rated input, strip length, and number of strips among various Govee RGB LED Strip Light models (H615E, H615A, H615B, H615C, H615D, H6159, H6110, H614B, H614E) while confirming other specifications are identical to the tested model.
Preview Govee RGB LED Strip Light FCC & IC Compliance Test Report
This document presents the comprehensive test report for the Govee RGB LED Strip Light, covering models H615E, H615A, H615B, H615C, H615D, H6159, H6110, H614B, and H614E. Conducted by China Certification ICT Co., Ltd (Dongguan), the report details compliance with FCC Part 15 Subpart C and ISED Canada RSS standards for radio equipment, ensuring regulatory adherence and product safety.