aid: govee url: https://raw.githubusercontent.com/api-evangelist/govee/refs/heads/main/apis.yml name: Govee kind: company description: 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. image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg tags: - Smart Home - Smart Lighting - IoT - LED - Home Automation - Device Control created: '2026-07-03' modified: '2026-07-03' specificationVersion: '0.19' apis: - aid: govee:govee-devices-api name: Govee Devices API tags: - Devices - Discovery - Capabilities image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://developer.govee.com/reference/get-you-devices baseURL: https://openapi.api.govee.com/router/api/v1 properties: - url: https://developer.govee.com/docs/getting-started type: Documentation - url: https://developer.govee.com/reference/get-you-devices type: APIReference - url: openapi/govee-openapi.yml type: OpenAPI - url: collections/govee.postman_collection.json type: PostmanCollection - url: collections/govee.opencollection.json type: OpenCollection description: 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 list (on_off, range/brightness, color_setting, segment_color_setting, dynamic scenes, and more) that tells you what commands a device accepts. - aid: govee:govee-device-state-api name: Govee Device State API tags: - Device State - Query - Status image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://developer.govee.com/reference/get-devices-status baseURL: https://openapi.api.govee.com/router/api/v1 properties: - url: https://developer.govee.com/reference/get-devices-status type: APIReference - url: openapi/govee-openapi.yml type: OpenAPI - url: collections/govee.postman_collection.json type: PostmanCollection - url: collections/govee.opencollection.json type: OpenCollection description: 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. Offline devices return their last known (historical) state; event-only capabilities cannot be queried directly. - aid: govee:govee-device-control-api name: Govee Device Control API tags: - Device Control - Commands - Power - Color image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://developer.govee.com/reference/control-you-devices baseURL: https://openapi.api.govee.com/router/api/v1 properties: - url: https://developer.govee.com/reference/control-you-devices type: APIReference - url: openapi/govee-openapi.yml type: OpenAPI - url: collections/govee.postman_collection.json type: PostmanCollection - url: collections/govee.opencollection.json type: OpenCollection description: 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 temperature (color_setting), toggle features (nightlight, oscillation), select a mode, or drive work_mode and temperature_setting capabilities on appliances. - aid: govee:govee-dynamic-scenes-api name: Govee Dynamic Scenes API tags: - Scenes - Light Scenes - Effects image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://developer.govee.com/reference/get-light-scene baseURL: https://openapi.api.govee.com/router/api/v1 properties: - url: https://developer.govee.com/reference/get-light-scene type: APIReference - url: openapi/govee-openapi.yml type: OpenAPI - url: collections/govee.postman_collection.json type: PostmanCollection - url: collections/govee.opencollection.json type: OpenCollection description: 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 can then be applied through the Device Control API's dynamic_scene capability. - aid: govee:govee-diy-scenes-api name: Govee DIY Scenes API tags: - DIY Scenes - Custom Effects image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://developer.govee.com/reference/control-you-devices baseURL: https://openapi.api.govee.com/router/api/v1 properties: - url: https://developer.govee.com/reference/control-you-devices type: APIReference - url: openapi/govee-openapi.yml type: OpenAPI - url: collections/govee.postman_collection.json type: PostmanCollection - url: collections/govee.opencollection.json type: OpenCollection description: 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 be applied through the Device Control API's diy_scene capability. - aid: govee:govee-segment-control-api name: Govee Segment Color and Brightness API tags: - Segment Control - RGBIC - Color - Brightness image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://developer.govee.com/reference/control-you-devices baseURL: https://openapi.api.govee.com/router/api/v1 properties: - url: https://developer.govee.com/reference/control-you-devices type: APIReference - url: openapi/govee-openapi.yml type: OpenAPI - url: collections/govee.postman_collection.json type: PostmanCollection - url: collections/govee.opencollection.json type: OpenCollection description: Address individual segments of RGBIC lights independently via the Device Control endpoint's segment_color_setting capability - set per-segment RGB color (segmentedColorRgb) or per-segment brightness (segmentedBrightness) by passing the target segment index array plus the color or brightness value. common: - type: DomainSecurity url: security/govee-domain-security.yml - type: Authentication url: authentication/govee-authentication.yml - type: GitHubOrganization url: https://github.com/Govee-API - type: LinkedIn url: https://www.linkedin.com/company/govee - type: Website url: https://www.govee.com - type: Documentation url: https://developer.govee.com/ - type: Plans url: plans/govee-plans-pricing.yml - type: RateLimits url: rate-limits/govee-rate-limits.yml - type: FinOps url: finops/govee-finops.yml maintainers: - FN: Kin Lane email: kin@apievangelist.com