Govee

Govee builds smart lighting and smart-home devices - RGBIC LED strips, light bars, floor and table lamps, string and permanent outdoor lights, plus sensors, humidifiers, heaters, and other connected appliances. The Govee Developer API (v1, hosted at https://openapi.api.govee.com/router/api/v1) is a free, cloud REST API authenticated with a Govee-API-Key header that lets developers enumerate a user's devices and their capabilities, query live device state, and send control commands - power, brightness, RGB and color-temperature, dynamic light scenes, DIY scenes, and per-segment color and brightness. Device events (for capabilities that support them) are delivered over MQTT, and a separate local LAN API allows direct UDP control on the local network.

6 APIs 0 Features
Smart HomeSmart LightingIoTLEDHome AutomationDevice Control

APIs

Govee Devices API

Enumerate all supported devices in a Govee account and discover each device's capabilities - the sku (product model), device id, user-assigned name, and the typed capability lis...

Govee Device State API

Query the current state and property values of a specific device by sku and device id - power, online status, brightness, color, color temperature, and other capability states. ...

Govee Device Control API

Send control commands to a device by passing a single typed capability - turn power on/off (on_off/powerSwitch), set brightness (range), set an RGB color or Kelvin color tempera...

Govee Dynamic Scenes API

Retrieve the list of dynamic (light) scenes a device supports - Govee's built-in lighting effects such as Sunrise, Aurora, or Rainbow - each returned as a selectable option that...

Govee DIY Scenes API

Retrieve the user-created DIY scenes a device supports - custom lighting effects authored by the user in the Govee Home App - each returned as a selectable option that can then ...

Govee Segment Color and Brightness API

Address individual segments of RGBIC lights independently via the Device Control endpoint's segment_color_setting capability - set per-segment RGB color (segmentedColorRgb) or p...

Collections

Govee Developer API

OPEN

Pricing Plans

Govee Plans Pricing

2 plans

PLANS

Rate Limits

Govee Rate Limits

3 limits

RATE LIMITS

FinOps

Govee Finops

FINOPS

Resources

🔗
DomainSecurity
DomainSecurity
🔑
Authentication
Authentication
👥
GitHubOrganization
GitHubOrganization
🔗
LinkedIn
LinkedIn
🔗
Website
Website
🔗
Documentation
Documentation
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: Govee Developer API
  version: '1.0'
request:
  auth:
    type: apikey
    key: Govee-API-Key
    value: '{{apiKey}}'
    in: header
items:
- info:
    name: Devices
    type: folder
  items:
  - info:
      name: Get devices and capabilities.
      type: http
    http:
      method: GET
      url: https://openapi.api.govee.com/router/api/v1/user/devices
    docs: Enumerate all supported devices in the account and their typed capability lists.
- info:
    name: Device State
    type: folder
  items:
  - info:
      name: Get the live state of a device.
      type: http
    http:
      method: POST
      url: https://openapi.api.govee.com/router/api/v1/device/state
      body:
        type: json
        data: "{\n  \"requestId\": \"uuid\",\n  \"payload\": {\n    \"sku\": \"H7143\",\n    \"device\": \"52:8B:D4:AD:FC:45:5D:FE\"\
          \n  }\n}"
    docs: Query the current state and property values of a device by sku and device id.
- info:
    name: Device Control
    type: folder
  items:
  - info:
      name: Turn a device on or off.
      type: http
    http:
      method: POST
      url: https://openapi.api.govee.com/router/api/v1/device/control
      body:
        type: json
        data: "{\n  \"requestId\": \"uuid\",\n  \"payload\": {\n    \"sku\": \"H6199\",\n    \"device\": \"52:8B:D4:AD:FC:45:5D:FE\"\
          ,\n    \"capability\": {\n      \"type\": \"devices.capabilities.on_off\",\n      \"instance\": \"powerSwitch\"\
          ,\n      \"value\": 1\n    }\n  }\n}"
    docs: Send an on_off/powerSwitch command (value 1 on, 0 off).
  - info:
      name: Set device brightness.
      type: http
    http:
      method: POST
      url: https://openapi.api.govee.com/router/api/v1/device/control
      body:
        type: json
        data: "{\n  \"requestId\": \"uuid\",\n  \"payload\": {\n    \"sku\": \"H6199\",\n    \"device\": \"52:8B:D4:AD:FC:45:5D:FE\"\
          ,\n    \"capability\": {\n      \"type\": \"devices.capabilities.range\",\n      \"instance\": \"brightness\",\n\
          \      \"value\": 50\n    }\n  }\n}"
    docs: Send a range/brightness command within the device's documented range.
  - info:
      name: Set device RGB color.
      type: http
    http:
      method: POST
      url: https://openapi.api.govee.com/router/api/v1/device/control
      body:
        type: json
        data: "{\n  \"requestId\": \"uuid\",\n  \"payload\": {\n    \"sku\": \"H6199\",\n    \"device\": \"52:8B:D4:AD:FC:45:5D:FE\"\
          ,\n    \"capability\": {\n      \"type\": \"devices.capabilities.color_setting\",\n      \"instance\": \"colorRgb\"\
          ,\n      \"value\": 16711680\n    }\n  }\n}"
    docs: Send a color_setting/colorRgb command as an integer 0-16777215.
  - info:
      name: Set per-segment color on RGBIC lights.
      type: http
    http:
      method: POST
      url: https://openapi.api.govee.com/router/api/v1/device/control
      body:
        type: json
        data: "{\n  \"requestId\": \"uuid\",\n  \"payload\": {\n    \"sku\": \"H6199\",\n    \"device\": \"52:8B:D4:AD:FC:45:5D:FE\"\
          ,\n    \"capability\": {\n      \"type\": \"devices.capabilities.segment_color_setting\",\n      \"instance\": \"\
          segmentedColorRgb\",\n      \"value\": { \"segment\": [0, 1, 2], \"rgb\": 16711680 }\n    }\n  }\n}"
    docs: Send a segment_color_setting/segmentedColorRgb command targeting a segment index array.
- info:
    name: Scenes
    type: folder
  items:
  - info:
      name: Get dynamic light scenes.
      type: http
    http:
      method: POST
      url: https://openapi.api.govee.com/router/api/v1/device/scenes
      body:
        type: json
        data: "{\n  \"requestId\": \"uuid\",\n  \"payload\": {\n    \"sku\": \"H6199\",\n    \"device\": \"52:8B:D4:AD:FC:45:5D:FE\"\
          \n  }\n}"
    docs: Retrieve the dynamic (light) scenes a device supports.
  - info:
      name: Get DIY scenes.
      type: http
    http:
      method: POST
      url: https://openapi.api.govee.com/router/api/v1/device/diy-scenes
      body:
        type: json
        data: "{\n  \"requestId\": \"uuid\",\n  \"payload\": {\n    \"sku\": \"H6199\",\n    \"device\": \"52:8B:D4:AD:FC:45:5D:FE\"\
          \n  }\n}"
    docs: Retrieve the user-created DIY scenes a device supports.
bundled: true